PCDIR(1)                COMMAND REFERENCE                PCDIR(1)



NAME
     pcdir - list directory contents of PC-DOS filesystem

SYNOPSIS
     pcdir [ -msw ] [ -eh ] [ -l ] [ -p ] [ -u ] [ -v ] [ file ]

DESCRIPTION
     Pcdir displays the PC-DOS filesystem directory entries.  If
     no file is specified, the root directory of /dev/rdfp is
     displayed.  The directory information is normally displayed
     in PC-DOS format.  Several output formats are available (see
     options).

     File is a PC-DOS file and takes the form of

     pseudodisk[:/]pathname

     where pseudodisk is the name of the UTek device or file
     containing the PC-DOS filesystem.  The : is the PC-DOS
     filesystem identifier.  The leading / of the PC-DOS pathname
     is optional if the optional : is specified; but at least one
     of the two delimiters must be specified.  The character \
     (back-slash) may be used in place of / when specifying the
     PC-DOS pathname. The PC-DOS pathname is the "directory-
     path/file" of the PC-DOS file(s) within the PC-DOS
     filesystem.

     Wild-cards are permitted as normally when referencing the
     pseudodisk. Wild-cards are allowed in the PC-DOS pathname if
     escaped or quoted.  The wild-cards when used in referencing
     a PC-DOS pathname are sh type wild-cards irregardless of
     what shell is in use at the time; *.* does not match FOO.,
     but does match foo.txt.

OPTIONS
     All of the options may be either upper or lower case.

     -m   the modes of the file(s) are displayed; W represents
          the file is write-able, H represents the file is a
          "hidden" file, S represents the file is a "system"
          file.

     -s   prints the names one per line, particularly useful when
          used with the -u and -v options.

     -w   forces a wide format which packs several names onto a
          line.  particularly useful when used with the -u and -v
          options.

     -e   prints every file to be displayed, including those
          which are "hidden".




Printed 7/4/87                                                  1

PCDIR(1)                COMMAND REFERENCE                PCDIR(1)



     -h   prints only those file(s) which are "hidden".

     -l   the full path to the file is displayed, particularly
          useful when used with the -s or -w options.

     -p   sends the output through a pager.

     -u   prints the file information in UTek style.

     -v   removes the header and footer lines.

FILES
     /usr/tmp/pcpath??????
          contains the sh expanded UTek file paths.

EXAMPLES
     This example will list the contents of the directory mydir
     within the PC-DOS filesystem in PCpdisk2 in wide format and
     paging the output.

     pcdir -wp PCpdisk2:mydir

     The next example will list all entries in the PC-DOS root
     directory contained within the PC-DOS filesystem in
     /dev/rdfp which match myfile with suffixes.  If any of the
     matches are a directory, the directory entry is listed; not
     the contents of the directory.  Note that the * is escaped.

     pcdir /dev/rdfp:/myfile.\*

VARIABLES
     PAGER          is the program used to page the output

     If the PAGER is not specified, it defaults to more if it
     can, or to cat otherwise.

RETURN VALUES
     [NO_ERRS]      Command completed without error.

     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [NP_WARN]      An error warranting a warning message
                    occurred. Execution continues.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.

CAVEATS
     The filesystem space usage at the tail of the directory
     (file) listing reflects the space usage of the PC-DOS
     filesystem only; it does not reflect the space usage of the



Printed 7/4/87                                                  2

PCDIR(1)                COMMAND REFERENCE                PCDIR(1)



     UTek filesystem.

     Wild-cards and back-slashes must be escaped or quoted when
     used in reference to the PC-DOS pathname. Wild-cards used in
     reference to the path of the PC-DOS filesystem and other
     UTek files should not be escaped or quoted unless the shell
     environment requires them to be escaped and in that case,
     multiple escapes and/or quotes are required in the PC-DOS
     filename.

     Unknown results may occur if a specified argument appears to
     be a valid PC-DOS filesystem but really isn't.  This is most
     likely to occur when accessing an existing binary file on
     UTek with the 1st byte being one of the characters 0xE9 or
     0xEB and the 24th byte being one of 0xF8 or 0xFD (a valid
     boot-parameter-block); or the 513th byte being one of 0xF8
     or 0xFD (the first byte of the FAT).

     An ioctl to the floppy driver is required when the diskette
     is formatted as single-sided or 8 sector/track; therefore,
     anytime the floppy driver is accessed and the device name
     was not specified as rdfp or rdf00p the device is changed to
     rdfp or rdf00p.

SEE ALSO
     pclabel(1). pcedit(1), pccopy(1), more(1), sh(1), pcsh(1).





























Printed 7/4/87                                                  3

%%index%%
na:72,88;
sy:160,267;
de:427,1570;
op:1997,766;2907,406;
ex:3433,776;
fi:3313,120;
va:4209,687;
ca:4896,235;5275,1273;
se:6548,211;
%%index%%000000000165