[net.sources] label.c man page

saj@iuvax.UUCP (02/15/84)

#N:iuvax:11700009:000:1242
iuvax!apratt    Jan  9 04:30:00 1984

LABEL(1)		MS-DOS PROGRAMMER'S MANUAL		       LABEL(1)


NAME	
	label - alter the volume label of a disk

SYNOPSYS
	label newlabel [d]

DESCRIPTION
	Changes the label on the specified drive "d", or on the
	default drive if d is not specified, to "newlabel". If the disk
	already had a label, the time and date of that label are retained.

	Note that volume labels are always exactly eleven characters long.
	Longer labels are truncated; shorter ones are padded with blanks.

MESSAGES

	There are three error messages:

		label: newlabel [d] 

	is issued when no arguments, or too many, are supplied.

		label: illegal drive specifier

	is issued when the second argument is not in (A-Z, a-z).

		label: cannot create new label

	is issued when the "create file" bdos function returns an
	error code.

BUGS
	Because the label is created as a file with the "label"
	attribute ON, the name is converted (by MS-DOS) to upper case.

	Only the first character of the "drive" argument is
	used/checked.

	As noted, the time/date stamp on the label is NOT updated if
	the volume had a label before. This may not be a bug, actually:
	it tells you when this disk was last checked for bad sectors.


LABEL(1)		MS-DOS PROGRAMMER'S MANUAL		       LABEL(1)