calsc(1) CLIX calsc(1)
NAME
ca_lsc - Lists contents of files/directories that have been fully cached
within the cache file system
SYNOPSIS
/bin/ca_lsc [-RadCxmnlogrtucpFbqisfL] [name ... ]
FLAGS
-R Recursively lists subdirectories encountered.
-a Lists all entries, including those that begin with a dot (.), which
are normally not listed.
-d If an argument is a directory, lists only its name (not its
contents). This flag is often used with -l to get the directory's
status.
-C Displays multicolumn output with entries sorted down the columns.
-x Displays multicolumn output with entries sorted across rather than
down the page.
-m Displays in stream output format; files are listed across the page
separated by commas.
-l Lists in long format giving mode, number of links, owner, group, size
(in bytes), and time of last modification for each file (see below).
If the file is a special file, the size field will contain the major
and minor device numbers rather than a size. If the file is a
symbolic link, the pathname the link references is displayed preceded
by an arrow (->).
-n Same as -l except that the owner's user ID (UID) and group's group ID
(GID) numbers are displayed rather than the associated character
strings.
-o Same as -l except that the group is not displayed.
-g Same as -l except that the owner is not displayed.
-r Reverses the sort order to get reverse alphabetic or oldest first as
appropriate.
-t Sorts by time stamp (latest first) instead of by name. The default
is the last modification time. (See -u and -c.)
-u Uses the last access time instead of modification time for sorting
(with the -t flag) or displaying (with the -l flag).
2/94 - Intergraph Corporation 1
calsc(1) CLIX calsc(1)
-c Uses the last inode modification time (such as when a file was
created or a mode changed) for sorting (-t) or displaying (-l).
-p Puts a slash (/) after each filename if the file is a directory.
-F Puts a slash (/) after each filename if the file is a directory, puts
an asterisk (*) after each filename if the file is executable, and
puts an at sign (@) after each filename if the file is a symbolic
link.
-b Forces nongraphics characters in filenames to be displayed in the
octal \ddd notation.
-q Forces nongraphics characters in filenames to be displayed as the
character ?.
-i For each file, displays the inode number in the first column of the
report.
-s Gives size in blocks (including indirect blocks) for each entry.
-f Forces each argument to be interpreted as a directory and lists the
name found in each slot. This flag turns off -l, -t, -s, and -r and
turns on -a; the order is the order in which entries appear in the
directory.
-L If an argument is a symbolic link, displays the information about the
file or directory the link references rather than about the link
itself.
DESCRIPTION
The ca_lsc command lists files and directories that have been fully cached
into the magnetic cache partitions. The ca_lsc command will only list
files and directories associated with the cache file systems. The ca_lsc
command sorts its output alphabetically by default. If no argument is
given, the current directory listed. If several arguments are given, the
arguments are first sorted appropriately, but file arguments appear before
directories and their contents.
There are three major listing formats. The default format lists one entry
per line. The -C and -x flags enable multicolumn formats, and the -m flag
enables stream output format. To determine output formats for the -C, -x,
and -m flags, ca_lsc uses the environment variable COLUMNS to determine
the number of character positions available on one output line. If this
variable is not set, the terminfo database is used to determine the number
of columns based on the environment variable TERM. If this information
cannot be obtained, 80 columns are assumed.
The mode displayed under the -l flag consists of 10 characters. The first
character can be one of the following:
2 Intergraph Corporation - 2/94
calsc(1) CLIX calsc(1)
d The entry is a directory.
b The entry is a block special file.
c The entry is a character special file.
l The entry is a symbolic link.
p The entry is a fifo (named pipe) special file.
- The entry is an ordinary file.
The next 9 characters are interpreted as sets of three bits each. The
first set refers to the owner's permissions; the next set refers to
permissions of others in the file's user group; and the last set refers to
all others. Within each set, the 3 characters indicate (respectively)
permission to read, write, and execute the file as a program. Execute
permission for a directory is permission to search the directory for a
specified file.
The ca_lsc -l command displays its output as follows:
-rwxrwxrwx 1 robinson users 10876 Aug 29 9:42 my_cache_file
This horizontal configuration provides a lot of information. Reading from
right to left, it is seen that the current directory holds one file,
my_cache_file. Next, the file's contents were last modified at 9:42 a.m.
on August 29. The file is moderately sized, containing 10,876 characters,
or bytes. The file owner, or the user, belongs to the group users, and
the user name is robinson. The number (in this case 1) indicates the
number of links to file my_cache_file. Finally, the row of dashes and
letters shows that user, group, and others have permission to read, write,
and execute my_cache_file.
The execute (x) symbol occupies the third position of the 3 character
sequence. A - in the third position would have indicated a denial of
execution permissions.
The permissions are indicated as follows:
r The file is readable.
w The file is writable.
x The file is executable.
- The indicated permission is not granted.
l Mandatory locking will occur during access. (The set-group-ID bit is
on, and the group execution bit is off.)
2/94 - Intergraph Corporation 3
calsc(1) CLIX calsc(1)
s The set-user-ID or set-group-ID bit and the corresponding user or
group execution bits are on.
S Undefined bit-state. (The set-user-ID bit is on, and the user
execution bit is off).
t The 1000 (octal) bit, or sticky bit (see chmod(1)), and the execution
bit are on.
T The 1000 bit is on, and execution is off (undefined bit-state).
For user and group permissions, the third position is sometimes occupied
by a character other than x or -. The s, referring to the state of the
set-ID bit (the user's or the group's), can also occupy this position.
For example, the ability to assume the same ID as the user during
execution is used during login when the user begins as root but needs to
assume the identity stated at login.
In the sequence of group permissions, l can occupy the third position. l
refers to mandatory file and record locking. This permission describes a
file's ability to allow other files to lock its reading or writing
permissions during access.
For others permissions, the third position can be occupied by t or T.
These refer to the state of the sticky bit and execution permissions.
EXAMPLES
To list all entries, inode numbers, block sizes, and GID numbers of a
directory in the CAFS cache partitions, enter the ca_lsc command as
follows:
ca_lsc -aisn
FILES
/etc/passwd UIDs for cs_lsc -l and ca_lsc -o.
/etc/group GIDs for ca_lsc -l and ca_lsc -g.
/usr/lib/terminfo/?/* Terminal information database.
NOTES
The ca_lsc command will only display files and directories that are fully
cached. Files and or directories that are in the process of being cached
will not be displayed.
In a Remote File Sharing (RFS) environment, a user cannot have the
permissions that the output of the ca_lsc -l command implies.
4 Intergraph Corporation - 2/94
calsc(1) CLIX calsc(1)
Undisplayable characters in filenames can confuse the columnar output
flags.
DIAGNOSTICS
The following is a list of common error messages:
ca_lsc: out of memory
Could not allocate enough memory to continue.
can not access directory dirname
You do not have permission to look here.
EXIT VALUES
The ca_lsc command exits with a value of 0 if successful. If
unsuccessful, it exits with a nonzero value.
RELATED INFORMATION
Commands: ls(1), chmod(1), find(1)
AT&T UNIX System V System Administrator's Guide.
2/94 - Intergraph Corporation 5