CHGDESC

Name

chgdesc -- changes the description string of a PCASYS data file.

Synopsis

chgdesc <datafile><new_desc>

DESCRIPTION

Chgdesc replaces the existing description string of a PCASYS data file with the provided string.

The new description can be of any length, but it must not contain embedded newline characters. If it contains spaces, tabs, or shell metacharacters that are not to be expanded, then it should be quoted. To delete a file's description string, i.e. to replace it with the empty string, use '' (quoted empty string) as the string argument.

The command makes, and then removes, a temporary version of the data file, in the same directory as the original file; its filename is the original filename with _chgdesc<pid> appended, where <pid> is the process id of the chgdesc command instance. (In the unlikely event that a file of this name already exists, chgdesc exits with an error message, rather than replacing that file.) If the original data file is large, then make sure, before running chgdesc, that the disk partition where the original file lives has enough room for the temporary copy.

OPTIONS

<datafile>

Data file whose description field is to be changed.

<new_desc>

The new description string.

EXAMPLE(S)

From test/pcasys/execs/chgdesc/chgdesc.src:

% chgdesc fv1.acl 'fv1.cls' Puts the string fv1.cls in the description field of the file fv1.acl.

SEE ALSO

datainfo (1A)

AUTHOR

NIST/ITL/DIV894/Image Group