Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileDwritelabel()
Dreadlabel()                                                         GEMDOS

Syntax

LONG Dreadlabel( name, label, namelen )
char *name;
char *label;
WORD namelen;

Function      Dreadlabel() retrieves label from the specified filesystem.

Opcode        338 (0x0152)

Availability  Available when a 'MiNT' cookie with a version of at least
              1.12 exists.

Parameters    name is a path relative to the root filesystem
              (U:\) pointing to the disk to read the label from.

              label is a pointer to a memory buffer where the label
              is supposed to be written to.

              namelen is the length of the buffer pointed to by
              label.

Binding       move.w  namelen,-(sp)
              pea     label
              pea     name
              move.w  #$0152,-(sp)
              trap    #1
              lea     $0c(sp),sp

Return Value  Dreadlabel() returns E_OK on success or a negative GEMDOS
              error code otherwise.

Comments      Not all filesystems understand the concept of a disk label.

See Also      Dwritelabel()