uuls(1M)																  uuls(1M)

NAME

       uuls - 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:

	      o  Transactions,
	      o  Orphans, and
	      o  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 truncated 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 referenced 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
       failure 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 ALSO

       mail(1), uucp(1), uuto(1), uux(1), uuxqt(1M), stat(2).

								  TO BE OBSOLETED							  uuls(1M)