HP 3000 Manuals HP 3000 Manuals
LISTFILE
This command lists file and directory attributes through the use of
options. The LISTFILE information is a superset of the LISTF command
information.
Syntax
LISTFILE [[fileset=]{fileset }]
[ {(fileset[,fileset]...)}]
where option is:
[[;FORMAT=]format_opt] [[;SELEQ=]select_eq ] [[;NAME=] pattern] [;PASS]
[ ^indir]
[;{PERM}{TEMP}{PERMTEMP}] [;USENAME][;TREE][;NOTREE]
Parameters
fileset Specifies the set of files to be listed. The
default for fileset is @, meaning all MPE-named
files in your current working directory (CWD). If
fileset includes more than one file, be sure to
separate the file names with commas and enclose the
set in parentheses, for example:
:listfile (test1,test2,test3)
The files named in the fileset parameter can be
either in MPE or HFS syntax (explained below). The
file names dot (.) and dot-dot (..) have special
meaning, that is, current directory and the parent
of the current directory, respectively.
The fileset parameter that you type at the command
line (including command name, keywords and options)
can have, at most, 511 characters.
Using Wildcards
You may use the @, ? and # characters as wildcards
in any position in the file name. You may use the
- character as a wildcard in any position except as
the first character of the file name. These
wildcards have the following meaning:
@ matches 0 to 255 characters
? matches one character
# matches one digit
[ ] matches one character
specified between the
brackets
- if used within brackets ([
]), the hyphen (-) means a
range of characters. For
example, "[c - g]" means all
the characters between c and
g inclusive. The character
on the left must
alphabetically precede the
character on the right.
- If used immediately after the
left bracket ([), or just
before the right bracket (]),
hyphen (-) means the
character `-' itself.
For example, "[a-c]" means one of `a', `b', or `c',
whereas "[-a-c]" or "[a-c-]" means one of `a', `b',
`c', or `-'.
It is illegal to specify [c-a], or [a-A] because
`c' does not alphabetically precede `a' and
uppercase `A' comes before lowercase `a' (in ASCII
character evaluation). Also note that it is legal
to specify [A-z] and any legal special characters.
MPE Syntax
If fileset does not begin with the dot or slash
(indicating HFS syntax), it is parsed according to
MPE syntax and has the following form:
filename[.groupname[.accountname] ]
A LISTFILE command using MPE syntax does not
display files that do not follow the traditional
MPE naming conventions of up to eight character
names for files, groups and accounts.
If the fileset parameter does not specify
groupname, all the files (with uppercase names that
have up to 8 alphanumeric characters) in the
current working directory (CWD) are listed
irrespective of whether CWD is an MPE group or not.
For example, the following command lists the files
in all of the groups of the logon account:
LISTFILE @.@
In contrast, the next command lists all the files
in the CWD (which may be different from the logon
group). However, only those files whose names are
valid MPE names are displayed.
LISTFILE @
If the CWD is not an MPE group, the information
about the file is displayed in the new format as
discussed below.
You may have an MPE group that also contains files
with HFS syntax, for example, they are lowercase,
have long names, or contain special characters. To
see both MPE and HFS files in a group, type,
LISTFILE ./@
HFS Syntax
If the fileset begins with a dot (.) or a slash
(/), it is assumed to be in HFS syntax. The
characters composing the name may be selected from
the following set:
a-z
A-Z
0 1 2 3 4 5 6 7 8 9 - _ .
If the fileset parameter begins with a slash (/),
the pathname is assumed to be an absolute pathname;
otherwise, it is considered to be CWD relative.
If fileset ends in a slash, it is treated as a
directory name, and pattern is used to determine
the file names that match. All the directories and
files that match fileset are found, and searched
recursively to display the files and directories
that match pattern. For example, if fileset is
/SYS/@/, all files and subdirectories within SYS,
and all files and directories within those
subdirectories are displayed. The default for
pattern is @.
If fileset does not end in a slash, all of the
files that match fileset are displayed. For
example, if fileset is /SYS/@, you will see a list
of all files, subdirectories and groups in the SYS
directory, but not any files or subdirectories
within those directories.
If you have specified TREE, a trailing slash is
assumed at the end of the fileset. For example,
the command LISTFILE /SYS/@;TREE behaves like
LISTFILE /SYS/@/. On the other hand, if you
specify NOTREE, the trailing slash, if present at
the end of a fileset, is ignored. Hence, the
command LISTFILE /SYS/@/;NOTREE behaves like
LISTFILE /SYS/@.
format_opt A format selection. This parameter has no effect
on the files selected for display, but affects the
selection of information about the files that you
see. If fileset begins with a dot (.) or slash
(/), or if the CWD is different from your current
MPE group, or if you specify the ;TREE option, then
you will see the HFS output style. This, in part,
means that:
* Account, group, and directory names will end
in a slash (/).
* File names will appear at the end of the
output lines.
* Output begins in column two so that you can
more easily detect filename wraparound from
the previous line (which, if wrapping
occurs, will begin in column one).
The following table displays the format options available.
Format Options
-----------------------------------------------------------------------------------------------
| | | |
| Option | Name | Displayed Information |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| -2 | ACD | Displays the file's ACD (access control definition). System |
| | | Managers can view the ACD for any file. Account Managers |
| | | can view the ACD for files in that account. File creators |
| | | can view the ACD for their files. Other users can view an |
| | | ACD only if that ACD specifies that the user has RACD (read |
| | | ACD) access. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| -1 | LABEL | Shows only the file label in hexadecimal. The hexadecimal |
| | | display generated by this format option only serves a |
| | | diagnostic purpose in MPE/iX and is subject to change. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 0 | FILES | For each directory, this option displays PATH=The name of |
| | | the file is displayed in a multicolumn format. This is the |
| | | default. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 1 | SUMMARY | Displays the file name, file code, record size, record |
| | | format, and other file characteristics such as ASCII or |
| | | binary records, carriage-control option, file type, current |
| | | end-of-file location, and the maximum number of records |
| | | allowed in the file. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 2 | DISC | Displays the file name, file code, record size, file type, |
| | | current end-of-file location, and the maximum number of |
| | | records allowed in the file. It also displays the blocking |
| | | factor, number of sectors in use, number of extents |
| | | currently allocated, and the maximum number of extents |
| | | allowed. |
| | | |
-----------------------------------------------------------------------------------------------
Format Options
-----------------------------------------------------------------------------------------------
| | | |
| Option | Name | Displayed Information |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 3 | DETAIL | Displays the file name, record size, extent size, number of |
| -3 | DETAIL;PASS | records, user's access rights, and other file |
| | | characteristics including the date created, modified, and |
| | | last accessed. The same information for MPE and HFS files |
| | | is displayed except for the following differences: |
| | | |
| | | |
| | | * Fully qualified MPE file name is replaced by an |
| | | absolute pathname. |
| | | |
| | | * Creator field displays the fully qualified user ID |
| | | (user.acct) of the file owner. |
| | | |
| | | * For MPE groups, the SECURITY field displays SAVE; for |
| | | entries other than MPE groups it is blank. All file |
| | | access matrix fields are blank for anything other |
| | | than MPE accounts, MPE groups, and files in an MPE |
| | | group. |
| | | |
| | | * The LOCKWORD field is omitted. |
| | | |
| | | The creator, group id, and label address are omitted in |
| | | FORMAT=3. These can be obtained by specifying -3 if you |
| | | have sufficient capability (AM or SM) |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 4 | SECURITY | Displays the security matrix for the file. This includes |
| | | account, group and file-level security, and the access |
| | | rights for the user. |
| | | |
| | | For MPE groups and MPE accounts, the security matrix for |
| | | group, account, and account-only are displayed. The rest of |
| | | the fields of the file access matrix are blank. |
| | | |
| | | For HFS directories, and files within HFS directories, all |
| | | the fields of the file access matrix are blank. In |
| | | addition, LISTFILE displays the message ACD EXISTS. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 5 | DATA | Shows LISTFILE,3 data and all file-specific data in |
| -5 | DATA;PASS | LISTFILE,3 type format (KSAM, SPOOL, and symbolic links). |
| | | If a file has no unique data, only the option 3 data is |
| | | shown. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 6 | QUALIFY | Shows the absolute pathname of the file. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 7 | UNIQUE | Shows all file specific data in LISTFILE,5 type format, but |
| | | does not show LISTFILE,3 data. If a file has no unique |
| | | data, only the file name is displayed. Default = 0 (FILES). |
| | | |
-----------------------------------------------------------------------------------------------
select_eq A selection equation. Use the selection equation
as a filter on fileset. From the set of files
matching the fileset, only files that match the
select_eq requirements are listed. You may select
file types by using the FTYPE option, or you may
select object types by using the OBJECT option.
Selection equations have the following format:
[FTYPE = KSAMXL | SPOOL]
[OBJECT = ACCT | GROUP | FILE | DIR
| HFSDIR | SYMLINK]
You must enclose selection equations in square
brackets. For example:
LISTFILE ./@ ;SELEQ=[OBJECT=DIR]
You can also use your text editor to make a file
that contains the OBJECT or FTYPE statement, for
example [OBJECT=DIR], and save it with a filename.
Thereafter, you can select this file by entering
the following command:
LISTFILE ./@ ;SELEQ=^FILENAME
The OBJECT option applies to HFS files, and may
have any one of the following values.
ACCT Lists only the MPE ACCOUNT
directory. You may use
ACCTS, ACCOUNT, ACCOUNTS as
synonyms for ACCOUNT.
GROUP Lists only the MPE GROUP
directory. You may use
GROUPS as a synonym for
GROUP.
FILE Lists only the files and not
directories/groups/accounts.
You may use FILES as a
synonym for FILE.
DIR Lists only directories
(including groups/accounts
and the system root directory
/). You may use DIRS,
DIRECTORY, or DIRECTORIES as
synonyms for DIRECTORY.
HFSDIR Lists only directories other
than root, accounts, and
groups.
SYMLINK Lists only symbolic links.
pattern When POSIX syntax is used in the fileset, pattern
is exactly the same as the filename components of
fileset as previously described. The name
parameter applies only to HFS syntax.
The LISTFILE command displays only those file names
which match the pattern. For example,
LISTFILE /SYS/;NAME=OFF@
displays all the files/groups/directories under the
SYS account that start with OFF, off, Off, and so
on.
If pattern is specified within single or double
quotes, it is case sensitive. For example,
LISTFILE /SYS/;NAME=`OFF@'
displays all the files/groups/directories under the
SYS account that start with OFF. It will not
display names that start with off, Off, and so on.
The default for the pattern parameter is @; that
is, it matches all names without regard to case.
__________________________________________________
NOTE You cannot use the NAME parameter for an MPE
fileset because pattern can be specified as
the part of the fileset. So, for example,
instead of entering the command LISTFILE
@.@.@;NAME=@DOC, enter the command LISTFILE
@DOC.@.@. instead.
__________________________________________________
PASS The PASS option displays sensitive data. Using it
depends on your access rights to the data; that is
if you are the owner or have AM or SM capability.
PERM The PERM option displays permanent files only. `
`PERM'' is the default.
TEMP The TEMP option displays temporary files only.
PERMTEMP The PERMTEMP option displays both permanent and
temporary files. The permanent files are listed
before the temporary files.
USENAME The USENAME option applies only to HFS-named
filesets. This option indicates that the name is
to be used to determine how many levels to display.
If the fileset ends in a slash (/), then all files
at all levels below the target file are displayed.
If the name does not end in a slash (/), then only
the files at the specified level are displayed.
For example, /@/@/@ indicates that all objects at
the third level are to be displayed. USENAME is
the default.
TREE If the TREE option is specified, objects at all
lower directory levels are displayed.
NOTREE Indicates that only objects at the specified level
are to be displayed. The NOTREE option overrides
an HFS fileset that ends in a slash.
Operation Notes
You can use LISTFILE to list descriptions of one or more disk files at
the level of detail you select. You must have traverse directory entries
(TD) and/or read directory entries (RD) access for the directories in the
pathname of the files that will be displayed by LISTFILE. (Refer to the
ALTSEC command for further information on directory permissions.)
For example, if the fileset is /dir1/dir@/@, you must have TD access for
the root directory (/) and dir1. Also, you must have RD access for dir1
since the next name is wildcarded (dir@) and have RD access to each
directory within the path specified by /dir1/dir@ since the next (and
final) name is a wildcard (@).
For format options -1, -2, -3, and -5, you must have either SM or AM
capability for the file. A file description is not listed unless the
file's home volume set (PV) is mounted.
Use
This command may be issued from a session, a job, a program, or in BREAK.
Pressing Break aborts execution.
If the fileset is in MPE syntax, LISTFILE only displays file names that
follow MPE naming syntax. For example, LISTFILE @,2 will not display the
file am_pm, whereas LISTFILE ./@,2 will display the file.
If fileset ends in a slash (/) or the ;TREE option, then the contents of
every matching directory will be displayed recursively. To see just a
directory name, but not all the files under it, use the ;NOTREE option or
omit the trailing slash.
MPE Examples
LISTFILE @
FILENAME
FILE1
LISTFILE @.PUB.OFFICE,2
ACCOUNT= OFFICE GROUP= PUB
FILENAME CODE ------------LOGICAL RECORD----------- ----SPACE----
SIZE TYP EOF LIMIT R/B SECTORS #X MX
F4 80B AF 411 411 16 144 2 *
F5 80B AF 199 199 16 64 1 *
HFS Examples
The following figure illustrates a hierarchical directory structure. In
this figure, directory names are shown as the character d plus a number
(for example, d0), and file names are shown as the character f plus a
number (for example, f1). The examples assume the directory structure
shown. They also assume that the current working directory (CWD) is
/ACCT/GROUP/d0.
Example File System
/ACCT/GROUP/d0 = CWD
|
-----------------------------------|---------------------------------------
| | | | | |
d1 d2 d3 f1 f2 f3
| |
--------------|--------------- ----|--------------
| | | | | | | | | | |
d4 f4 f5 d5 d6 f6 d7 f7 f8 f9 f10
| | | |
---|-- ---| -----|---- --|-----------------------
| | | | | | | | | | | |
f11 f12 d8 f13 f14 f15 d9 f16 f17 f18 f19 f20
The first example below sets the `HPPROMPT'' variable to show the current
working directory, changes the CWD to d0, and produces a listing of all
files one level below the CWD.
:hello manager.acct,group
:setvar hpprompt "!!hpcwd:"
/ACCT/GROUP:chdir ./d0
CWD is "/ACCT/GROUP/d0".
/ACCT/GROUP/d0:listfile ./@
PATH= /ACCT/GROUP/d0/
d1/ d2/ d3/ f1 f2 f3
The next example produces a listing of all files one level below the CWD
using FORMAT=2 (DISC) option.
/ACCT/GROUP/d0:listfile ./@,2
PATH= /ACCT/GROUP/d0/./
CODE ------------LOGICAL RECORD----------- ----SPACE---- FILENAME
SIZE TYP EOF LIMIT R/B SECTORS #X MX
16W HBD 4 67107839 1 64 2 * d1/
16W HBD 4 67107839 1 64 2 * d2/
16W HBD 4 67107839 1 64 2 * d3/
80B AF 12 12 1 16 1 1 f1
80B AF 12 12 1 16 1 1 f2
80B AF 12 12 1 16 1 1 f3
In the next example, specifying the absolute pathname produces a listing
of all entries one level below the group.
/ACCT/GROUP/d0:listfile /ACCT/GROUP/@,2
PATH= /ACCT/GROUP/
CODE ------------LOGICAL RECORD----------- ----SPACE---- FILENAME
SIZE TYP EOF LIMIT R/B SECTORS #X MX
16W HBD 4 67107839 1 64 2 * *d0/
In the next example, specifying the NAME parameter produces a listing of
all entries with names beginning with a lower case "d". Using the
FORMAT=6 (QUALIFY) option shows the absolute pathname of all HFS entries.
/ACCT/GROUP/d0:listfile /;name=`d@';format=6
/ACCT/GROUP/d0/
/ACCT/GROUP/d0/d1/
/ACCT/GROUP/d0/d2/
/ACCT/GROUP/d0/d2/d4/
/ACCT/GROUP/d0/d2/d5/
/ACCT/GROUP/d0/d2/d5/d8/
/ACCT/GROUP/d0/d2/d6/
/ACCT/GROUP/d0/d3/
/ACCT/GROUP/d0/d3/d7/
/ACCT/GROUP/d0/d3/d7/d9/
The next example illustrates the use of the OBJECT=ACCT parameter to show
all accounts on the system.
/ACCT/GROUP/d0:listfile /@,6; seleq=[object=acct]
/ACCT/
/SYS/
/TELESUP/
/TEST/
.
.
.
The next example illustrates the OBJECT=GROUP parameter to show all
groups on the system.
/ACCT/GROUP/d0:listfile /@/@;seleq=[object=group];format=qualify
/ACCT/GROUP/
/ACCT/PUB/
/SYS/ALINE925/
.
.
.
/TELESUP/PUB/
/TEST/PUB/
/TEST/SPOOL/
/TEST/SPOOLSTD/
/TEST/TEMPLATE/
/ACCT/GROUP/d0:
The next example illustrates the use of the OBJECT=DIR parameter to show
all directories on the system. This is similar to the FINDDIR UDC.
/ACCT/GROUP/d0:listfile /, qualify;seleq=[object=dir];format=qualify
/
/ACCT/
/ACCT/GROUP/
/ACCT/GROUP/d0/
/ACCT/GROUP/d0/d1/
/ACCT/GROUP/d0/d2/
/ACCT/GROUP/d0/d2/d4/
/ACCT/GROUP/d0/d2/d5/
/ACCT/GROUP/d0/d2/d5/d8/
/ACCT/GROUP/d0/d2/d6/
/ACCT/GROUP/d0/d3/
/ACCT/GROUP/d0/d3/d7/
/ACCT/GROUP/d0/d3/d7/d9/
/ACCT/PUB/
/SYS/
/SYS/ALINE925/
/SYS/ALINK925/
.
.
.
/TELESUP/PUB/
/TEST/PUB/
/TEST/SPOOL/
/TEST/SPOOLSTD/
/TEST/TEMPLATE/
.
.
.
The next example illustrates a summary listing (format option 1) of all
files in subdirectory d3.
/ACCT/GROUP/d0:listfile d3/@,1
PATH= /ACCT/GROUP/d0/./d3/
CODE ------------LOGICAL RECORD------- FILENAME
SIZE TYP EOF LIMIT
16W DBH 4 67107839 d7/
80B AF 12 12 f10
80B AF 12 12 f7
80B AF 12 12 f8
80B AF 12 12 f9
The next example illustrates a detail listing (format option 3) of all
files in subdirectory d3.
/ACCT/GROUP/d0:listfile ./d3/@,3
********************
FILE: /ACCT/GROUP/d0/d3/d7/
FILE CODE : 0 FOPTIONS: DIRECTORY
BLK FACTOR: 1 OWNER : **
REC SIZE: 32(BYTES) GROUP ID: **
BLK SIZE: 32(BYTES) SECURITY--READ :
EXT SIZE: 0(SECT) WRITE :
NUM REC: 4 APPEND :
NUM SEC: 64 LOCK :
NUM EXT: 2 EXECUTE :
MAX REC: 67107839 **SECURITY IS ON
FLAGS : NO ACCESSORS
NUM LABELS: 0 CREATED : TUE, JUL 21, 1992, 2:20 PM
MAX LABELS: 0 MODIFIED: TUE, JUL 21, 1992, 2:23 PM
DISC DEV #: 1 ACCESSED: WED, JUL 22, 1992, 12:05 PM
SEC OFFSET: 0 LABEL ADDR: **
VOLCLASS : MPEXL_SYSTEM_VOLUME_SET:DISC
********************
.
.
.
FILE: /ACCT/GROUP/d0/d3/f9
FILE CODE : 0 FOPTIONS: ASCII,FIXED,NOCCTL,STD
BLK FACTOR: 1 OWNER : **
REC SIZE: 80(BYTES) GROUP ID: **
BLK SIZE: 80(BYTES) SECURITY--READ :
EXT SIZE: 13(SECT) WRITE :
NUM REC: 12 APPEND :
NUM SEC: 16 LOCK :
NUM EXT: 1 EXECUTE :
MAX REC: 12 **SECURITY IS ON
MAX EXT: 1 FLAGS : NO ACCESSORS
NUM LABELS: 0 CREATED : TUE, JUL 21, 1992, 2:21 PM
MAX LABELS: 0 MODIFIED: TUE, JUL 21, 1992, 2:21 PM
DISC DEV #: 2 ACCESSED: TUE, JUL 21, 1992, 2:21 PM
SEC OFFSET: 0 LABEL ADDR: **
VOLCLASS : MPEXL_SYSTEM_VOLUME_SET:DISC
/ACCT/GROUP/d0:
The next example illustrates the use of the FORMAT=-3 option to show the
owner. You must be the owner, or have AM or SM capability to use this
option.
/ACCT/GROUP/d0:listfile /ACCT/GROUP/@,-3
********************
FILE: /ACCT/GROUP/d0/
FILE CODE : 0 FOPTIONS: DIRECTORY
BLK FACTOR: 1 OWNER : MANAGER.ACCT
REC SIZE: 32(BYTES) GROUP ID: ACCT
BLK SIZE: 32(BYTES) SECURITY--READ :
EXT SIZE: 0(SECT) WRITE :
NUM REC: 4 APPEND :
NUM SEC: 64 LOCK :
NUM EXT: 2 EXECUTE :
MAX REC: 67107839 **SECURITY IS ON
FLAGS : 1 ACCESSOR,SHARED
NUM LABELS: 0 CREATED : TUE, JUL 21, 1992, 1:10 PM
MAX LABELS: 0 MODIFIED: TUE, JUL 21, 1992, 2:16 PM
DISC DEV #: 2 ACCESSED: WED, JUL 22, 1992, 11:40 AM
SEC OFFSET: 0 LABEL ADDR: $000000E1 $0009A220
VOLCLASS : MPEXL_SYSTEM_VOLUME_SET:DISC
/ACCT/GROUP/d0:
The next example illustrates the use of the FORMAT=4 (SECURITY) option to
display the security matrix for all objects one level below the group (in
this case, d0).
/ACCT/GROUP/d0:listfile /ACCT/GROUP/@,4
********************
FILE: /ACCT/GROUP/d0/
ACCOUNT ------ READ :
WRITE :
APPEND :
LOCK :
EXECUTE :
GROUP -------- READ :
WRITE :
APPEND :
LOCK :
EXECUTE :
SAVE :
FILE --------- READ : FCODE: 0
WRITE : **SECURITY IS ON
APPEND : ACD EXISTS
LOCK :
EXECUTE :
FOR MANAGER.ACCT: RACD, TD, RD, CD, DD
The next example illustrates the use of the FORMAT=-2 (ACD) option to
display the access contol definition (ACD) for file f4 in subdirectory
d2. Note that all users (@.@) have read ACD (RACD) access for this file.
/ACCT/GROUP/d0:listfile ./d2/f4,-2
PATH= /ACCT/GROUP/d0/d2/
-----------ACD ENTRIES--------------- FILENAME
@.@ : RACD f4
/ACCT/GROUP/d0:
Related Information
Commands LISTF, PLISTF (UDC), LISTFTEMP, LISTSPF (for spool files),
FINDFILE (UDC), FINDDIR (UDC), LISTDIR (UDC)
Manuals None