Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

ls(1) [plan9 man page]

LS(1)							      General Commands Manual							     LS(1)

NAME
ls, lc - list contents of directory SYNOPSIS
ls [ -dlnpqrstuF ] name ... lc [ -dlnqrstuF ] name ... DESCRIPTION
For each directory argument, ls lists the contents of the directory; for each file argument, ls repeats its name and any other information requested. When no argument is given, the current directory is listed. By default, the output is sorted alphabetically by name. Lc is the same as ls, but sets the -p option and pipes the output through mc(1). There are a number of options: -d If argument is a directory, list it, not its contents. -l List in long format, giving mode (see below), file system type (e.g., for devices, the # code letter that names it; see Intro(4)), the instance or subdevice number, owner, group, size in bytes, and time of last modification for each file. -n Don't sort the listing. -p Print only the final path element of each file name. -q List the qid (see stat(2)) of each file. -r Reverse the order of sort. -s Give size in Kbytes for each entry. -t Sort by time modified (latest first) instead of by name. -u Under -t sort by time of last access; under -l print time of last access. -F Add the character / after all directory names and the character * after all executable files. The mode printed under the -l option contains 11 characters, interpreted as follows: the first character is d if the entry is a directory; a if the entry is an append-only file; - if the entry is a plain file. The next letter is l if the file is exclusive access (one writer or reader at a time). The last 9 characters are interpreted as three sets of three bits each. The first set refers to owner permissions; the next to permissions to others in the same user-group; and the last to all others. Within each set the three characters indicate permission respectively to read, to write, or to execute the file as a program. For a directory, `execute' permission is interpreted to mean permission to search the directory for a specified file. The permissions are indicated as follows: r if the file is readable; w if the file is writable; x if the file is executable; - if none of the above permissions is granted. SOURCE
/sys/src/cmd/ls.c /rc/bin/lc SEE ALSO
stat(2) mc(1) LS(1)

Check Out this Related Man Page

getacl(1)						      General Commands Manual							 getacl(1)

NAME
getacl - list access control lists (ACLs) for files (JFS File Systems only) SYNOPSIS
file... DESCRIPTION
For each argument that is a regular file, special file, or named pipe, displays the owner, group, and the Access Control List (ACL). For each directory argument, displays the owner, group, and the ACL and/or the default ACL. Only directories contain default ACLs. With the option specified, the filename, owner, group, and the ACL of the file will be displayed. With the option specified, the filename, owner, group, and the default ACL of the file, if it exists, will be displayed. With options not specified, the filename, owner, group, and both the ACL, and the default ACL, if it exists, will be displayed. This command may be executed on a file system that does not support ACLs. It will report the ACL consisting of only the owning user, own- ing group, class and other entries, based on the permission bits. When multiple files are specified on the command line, a blank line will separate the ACL for each file. Options The command recognizes the following options: Displays the filename, owner, group, and the ACL of the specified file. Displays the the filename, owner, group, and the default ACL of the file, if it exists. Operands The command recognizes the following operand: file The file or directory from which retrieves the access control information. ACL Format The format of an ACL is: The first three lines show the filename, the file owner, and the file owning group. Note that when only the option is specified, and the file has no default ACL, only these three lines will be displayed. The entry without a user ID indicates the permissions that will be granted to the owner of the file. One or more additional entries indi- cate the permissions that will be granted to the specified users. The entry without a group identifier indicates the permissions that will be granted to the owning group of the file. One or more additional entries indicate the permissions that will be granted to the specified groups. The entry indicates the permissions that will be granted to others. The entries and may only exist for directories, and indicate the default user, group, and other entries that will be added to a file cre- ated within the directory. The uid is a login name, or a user ID if there is no entry for the uid in the system's password file; gid is a group name, or a group ID if there is no entry for the gid in the system's group file; and perm is a three character string composed of the letters representing the separate discretionary access rights: (read), (write), (execute/search), or the placeholder character The perm will be displayed in the following order: If a permission is not granted by an ACL entry, the placeholder character will appear. The ACL entries will be displayed in the order in which they will be evaluated when an access check is performed. The default ACL entries that may exist on a directory have no effect on access checks. The file owner permission bits represent the access that the owning user ACL entry has. The file group class permission bits represent the most access that any additional user entry, additional group entry, or the owning group entry may grant. The file other permission bits represent the access that the other ACL entry has. If a user invokes the command and changes the file group class permission bits, the access granted by the additional ACL entries may be restricted. In order to indicate that the file group class permission bits restrict an ACL entry, will display, after each affected entry, text in the form , where perm will show only the permissions actually granted. EXAMPLES
Given file with an ACL six entries long, the command would print: Given file with an ACL six entries long, after the command was issued, the command would print: Given directory with an ACL containing default entries, the command would print: Given directory the command would print: NOTICES
The output from will be in the correct format for input to the command. If the output from is redirected to a file, the file may be used as input to In this way, a user may easily assign one file's ACL to another file. FILES
for user IDs for group IDs SEE ALSO
chmod(1), ls(1), setacl(1). acl(2), aclsort(3C). getacl(1)
Man Page