1 03/11/76 catalog, cat
2
3 Function: When a file is saved, its name and other information about
4 it is placed in the directory specified by default the user's home
5 directory. To print information about the files in a single
6 directory, the user can issue a catalog command. A variety of control
7 arguments allow the user to restrict the listing to a subset of files
8 and/or a subset of information. When no arguments are given, the
9 command prints the name, access mode, and length for each file in the
10 home directory in the order in which they were created. The star
11 convention is allowed see "File Naming Conventions" in Section III.
12
13
14 Syntax: catalog file_names -control_args
15
16
17 where:
18
19
20 1. file_names are a subset of the files whose
21 attributes are to be listed.
22 Listing of information about these
23 files depends on the control
24 arguments given.
25
26 2. control_args may be chosen from the arguments
27 given below and supplied in any
28 order. The basic output format of
29 catalog is a series of columns, each
30 of which corresponds to an attribute
31 of the file. If no attributes are
32 explicitly stated, name, access
33 mode, and records used are printed.
34 Otherwise, only the name and
35 specified attributes are printed.
36 Both totals and detailed information
37 are printed unless the user
38 specifies otherwise. Files are
39 printed in the order they occur
40 unless the user explicitly requests
41 a different order.
42
43 -pathname path, -pn path lists the contents of the directory
44 specified by path; if this control
45 argument is not supplied, the home
46 directory is assumed.
47
48 -name, -nm prints only the names column.
49
50 -date_time_entry_modified, prints the date and time the file
51 -dtem was last modified.
52
53 -total, -tt prints only the heading line, giving
54 the total number of files Multics
55 segments and the sum of their
56 sizes.
57
58 -no_header, -nhe omits all heading lines.
59
60
61 Example:
62
63 ! catalog
64
65 Segments = 4, Lengths = 26.
66
67 r w 10 test.basic
68 rew 9 test
69 r w 5 newfile
70 r w 2 summary.basic
71
72
73 ready 0910
74
75
76 ! catalog *.basic
77
78 Segments = 2, Lengths = 12.
79
80 r w 10 test.basic
81 r w 2 summary.basic
82
83
84 ready 0910
85
86
87 ! catalog *.basic -nm -nhe
88
89 test.basic
90 summary.basic
91
92
93 ready 0911
94
95
96 ! catalog -tt
97
98 Segments = 4, Lengths = 26.
99
100
101 ready 0911