uuls(1M)uuls(1M)NAMEuuls - list spooled uucp transactions grouped by transaction
SYNOPSIS
[directories]...
[directories]...
[directories]...
DESCRIPTION
The commands, including are targeted for removal from HP-UX; see the
below.
This command lists the contents of UUCP spool directories (default with
the files in each directory grouped into three categories:
· Transactions,
· Orphans, and
· Others.
Transactions
Each output line starts with a transaction control filename, and
includes the name of each local (same-directory) subfile referenced by
the control file (see below). Each is possibly followed by the total
size in bytes option) or Kbytes option) in the transaction (see below).
The (meanings) option replaces the subfile names with nodename, user,
and commandline information (see below).
Orphans
All subfiles not referenced by any control file.
Others
All other files in the directory (all files not listed under one of the
above categories).
Filenames are formatted into columns, so there can be more than one
file per line. If a transaction has more subfiles than fit on one
line, it is followed by continuation lines which are indented further.
The (size in bytes) and (Kbytes) options cause the command to follow
each transaction in the section with a total size for all stat-able,
sendable files in that transaction. This includes files only, not or
files. It does include stat-able files outside the spool directory
that are indirectly referenced by files. Sizes are either in bytes or
rounded to the nearest Kbyte (1024 bytes), respectively. A totals line
is also added at the end of the section.
The (meanings) option causes the command to follow and files with a
commandline line, instead of subfilenames. For files, one line is
printed per remote execution subfile it references. nodename is trun‐
cated at seven characters, username at eight, and commandline at how‐
ever much fits on one line.
If is given, for each file with no remote execution files, the command
instead shows the meaning of the file itself on one or more lines.
Each line consists of a username, then (receive) or (send), then the
name of the file to be transferred. See below for details.
Filenames are listed in ascending collation order within each section
(see Environment Variables below), except that the first section is
only sorted by the control filename. Every file in the directory
except and appears exactly once in the entire list, unless is used.
Details
Transaction files are those whose names start with or Subfilenames,
which usually start with are gleaned from control file lines, at most
one per line, from blank-separated fields, as follows:
C.*: R <remotefrom> <localto> <user> -<options>
C.*: S <localfrom> <remoteto> <user> -<options> <subfile> <mode>
X.*: F <subfile>
Lines that do not begin with the appropriate character or are ignored.
In the (receive) case, <remotefrom> is used to print the meaning, and
its transaction size is taken as zero (unknown).
In the (send) case, if <subfile> is <localfrom> is a file not in the
spool directory, resulting from a typical call without the (copy)
option. In this case <localfrom> is used for the transaction size, if
stat-able, and to print the meaning.
and both set <subfile> to a true (spooled) subfile name.
Orphan files are those whose names start with and which are not refer‐
enced by any control files.
This algorithm extracts from control files the names of all subfiles
that should exist in the spool directory when the transaction is not
being actively processed. It is not unusual to see "missing subfiles"
and "orphans" if you a spool directory while or is active.
Meanings information is obtained by reading each subfile referenced by
each file, and by reading files. is taken from the last line in the
file which is of the form:
U <username> <nodename>
Likewise, commandline is taken from the last line of the form:
C <commandline>
If a subfile name is referenced more than once, references after the
first show the subfile as missing. If a subfile name appears in a
(corrupt) directory more than once, the name is only found once, but
then it is listed again under
EXTERNAL INFLUENCES
Environment Variables
determines the order in which the output is sorted.
If is not specified in the environment or is set to the empty string,
the value of is used as a default. If is not specified or is set to
the empty string, a default of ``C'' (see lang(5)) is used instead of
If any internationalization variable contains an invalid setting,
behaves as if all internationalization variables are set to ``C'' (see
environ(5)).
DIAGNOSTICS
The program writes an appropriate message to standard error if it has
any problems dealing with a specified file (directory), including fail‐
ure to get heap space. It always returns zero as its exit value.
If a control file is unopenable (wrong permissions or it disappeared
while was running), its name is preceded by a and the size of the
transaction is zero. If a subfile is missing (filename not found in
the directory being listed) or not stat-able (if required for or its
name is preceded by a and it contributes zero bytes to the size of the
transaction.
If is specified and a file is missing or unreadable, its name is given
with a prefixed, as usual.
BUGS
This command uses chdir(2) to change to each directory in turn. If
more than one is specified, the second through last directories must be
absolute (not relative) pathnames, or the may fail.
WARNINGS
Use of commands, including is discouraged because they are targeted for
removal from HP-UX. Use ftp(1) or rcp(1) instead.
AUTHOR
was developed by HP.
SEE ALSOmail(1), uucp(1), uuto(1), uux(1), uuxqt(1M), stat(2).
TO BE OBSOLETED uuls(1M)
