-- ListDoc.tioga
-- last edited by: L. Stewart, December 20, 1983 1:32 pm
name List:
syntax
List {-switches} list-of-patterns
The -l switch (long format) causes List to use FS.Enumerate rather than FS.EnumerateForNames. It runs more slowly, but displays more information.
The -u switch (unbackedup) causes List to display only those files which are not FS attachments and which consequently are not backed up anywhere. List -u * is a good way to get a list of all such files. List -u *!H is probably most interesting because it returns pretty much what DFDisk "Unknown unknown" did.
The -a switch (print attached), causes printing of attachments. Forces the l switch on.
The -k switch (print keep) causes printing of the file keep. Forces the l switch on.
The -s switch (separate) causes list to put each file on a separate line.
The -e switch (everything) is equivalent to -lak.
The -f switch (full names) causes list to print the full names of files.
The -r switch (recursive) forces '* to match '/ and '> so you don't have to type **.
The -o switch (one line) causes the short form printout to list all the files on the same line. Has no affect on -l form printing.
description
The list command prints names and possibly information about files in the FS directory system. It is a user interface for the FS.EnumerateForInfo and FS.EnumerateForNames calls.
List works for both local and remote patterns.
List works in the current working directory if a pattern is not a full path.
List works with both / and [ style filenames.
If a pattern given to List is a directory name, (ends with a '/ or '>) then a '* is appended.
The pattern '* does not match the characters '/ or '>, but the pattern "**" does. This means that unless you use "**", List will not list any files in subdirectories. (However, it will list the names of subdirectories.)
examples
% list Compiler.log
[]<>Compiler.log!32
% list -l Compiler.log
Compiler.log!101 397 14-Dec-83 10:13:16

% List Comp*
Compiler.bcd!1
compiler.load!1
Compiler.log!27
%
warnings
List -u * will list only the names of those subdirectories which contain unbacked-up files, not the names of all subdirectories.
List -ur * means List -ur *!*, which will likely tell you about unbacked-up files that you don't care about. Try List -ur *!H or List -u **!H.
The level slicing enumeration isn't quite right at the moment: List /Ivy/Stewart/T*/A* will never return anything, because the List implementation says "Strip off the prefix before the first *. If there is a '/ in what is left, ignore the file." Someday this may improve.
stop/undo
Click the STOP! button.
implementation
FSFileCommandsImpl.mesa in CommandTool.df
contact
L. C. Stewart <Stewart.pa>
keyword hints
help button info man
keywords
to be supplied by the Index Czar