cdsuf(1M)                                                  cdsuf(1M)


       NAME
             cdsuf - read the System Use Fields from a System Use Area on
             CD-ROM

       SYNOPSIS
             cdsuf [-s number] [-b] file

       DESCRIPTION
             cdsuf lists the contents of the System Use Fields (which
             conform to the System Use Sharing Protocol) of the System Use
             Area associated with a File Section of a file or directory.
             Information in any continuation fields that are present is
             also displayed.

             The output is in the form of a table containing an entry for
             each System Use Field in the System Use Area recorded on the
             CD-ROM.  Each entry of the table has the fields Signature,
             Length, Version, and Data, as specified in the System Use
             Sharing Protocol.

             Only a privileged user can execute the command successfully.

          Options
             The following options are available:

            -s number
                    Specifies the File Section number for which the System
                    Use Area shall be read.  The numbering starts with 1.
                    If this option is omitted, the last File Section of
                    that file is assumed.

            -b     Copies all of the System Use Fields of the System Use
                    Area from the CD-ROM to standard output, in binary
                    format.

            file   Names the file or directory within the CD-ROM file
                    hierarchy.

          Environment Variables
             LC_TIME determines the format and contents of date and time
             strings.  If LC_TIME is not set in the environment or is set
             to the empty string, the value of LANG is used as the default.
             If LANG is not set or is set to the empty string, the
             corresponding value from the implementation-specific default
             locale is used.  If LC_TIME or LANG contain an invalid
             setting, the utility behaves as if none of the variables are


                           Copyright 1994 Novell, Inc.               Page 1

      cdsuf(1M)                                                  cdsuf(1M)


            defined.

         Exit Codes
            cdsuf exits with one of the following values:

              0    Successful completion

              1    File is not found.

              1    File is not a file or directory within a CD-ROM file
                   hierarchy.

              1    Access is denied.

              2    File section indicated by -s does not exist.

              3    File section indicated by -s has no System Use Area.

      REFERENCES
            cddevsuppl(1M), cd_getdevmap(3X), cd_setdevmap(3X),
            cd_suf(3X), environ(5)

            RockRidge from the Rock Ridge Technical Working Group

























                          Copyright 1994 Novell, Inc.               Page 2