zfsadm fileinfo

Purpose

Displays detailed information about a file or directory.

Format

zfsadm fileinfo -path name [{-globalonly| -localonly | -both}] [-level] [-help]

Options

-both: Causes the command to display both global and local information about the file or directory.
-globalonly: Causes the command to display global (on-disk) information about the file or directory. This option is the default.
-help: Prints the online help for this command. All other valid options that are specified with this option are ignored.
-level: Prints the level of the zfsadm command. This option is useful when you are diagnosing a problem. Except for -help, all other valid options that are specified with -level are ignored.
-localonly: Causes the command to display local (in memory on this system) information about the file or directory.
-path name: Specifies the path name of a file or directory about which information should be displayed. The path name is case-sensitive.

Usage

The zfsadm fileinfo command can be used to display information about a file or directory. It supports files and directories in version 1.4 aggregates. It also supports files and v4 or extended (v5) directories in version 1.5 aggregates.

If an aggregate has the converttov5 attribute assigned to it, accessing a v4 directory with zfsadm fileinfo can cause its conversion to n extended (v5) directory. For more information, see Converting an existing v4 directory to an extended (v5) directory.

The command must be issued from a z/OS® V2R1 system. The file or directory must be contained in a file system that is locally zFS-owned or in a client file system.

Some of the fields are only applicable to files, some are only applicable to directories, some are only applicable to the local system and some are only applicable to client systems. There can also be attributes that are sometimes associated with a file or directory, such as ACLs. When these situations occur, the fields of the output display will contain values such as 0 or na or none, depending on the type of value that the field contains when it does have valid information.

If the -globalonly option is specified (or defaulted), the following fields are displayed:

fid

The inode and uniquifier separated by a comma.

anode

Anode block and offset into anode block separated by a comma.

length

Length of data (directories are multiples of 8 K).

format

INLINE, FRAGMENTED, or BLOCKED.

1K blocks

Number of blocks that are used to store data, in kilobytes.

permissions

Permissions in octal format.

uid,gid

UID and GID of owner that is separated by a comma.

access acl

Anode index to ACL and length of ACL separated by a comma.

dir model acl

Anode index to directory model ACL and length of ACL separated by a comma.

file model acl

Anode index to file model ACL and length of ACL separated by a comma.

user audit

User audit flags for read, write, and execute:

N: None
S: Audit successful attempts
F: Audit failed attempts

auditor audit

Auditor audit flags for read, write, and execute:

N: None
S: Audit successful attempts
F: Audit failed attempts

set sticky,uid,gid

Sticky bit, set uid, and set gid separated by a comma.

seclabel

Security label for file or directory.

object type

DIR or FILE or LINK or CHARSPEC.

object linkcount

Link count for the object.

object genvalue

Object general attributes. This value is taken from at_genvalue in the z/OS UNIX structure ATTR.

dir version

The version of the directory; 5 indicates an extended (v5) directory and 4 indicates a v4 directory.

dir name count

The number of objects in an extended (v5) directory.

dir data version

A number that is incremented each time that the directory is changed.

dir tree status

For an extended (v5) directory, VALID (accessed by hash) or BROKEN (accessed as a flat file). Not applicable for a v4 directory.

dir conversion

For an extended (v5) directory, not applicable. For a v4 directory, FAILED (directory conversion was unsuccessful) or not applicable.

file format bits

For a file, the txt flag, the defer tag, the file format. For other objects, the text flag, the defer tag, and the file format are not applicable.

file charset id

The coded character set ID. This value is taken from at_charsetid in the z/OS UNIX structure ATTR.

file cver

Creation verifier. This value is taken from AT_cver in the z/OS UNIX structure ATTR.

charspec major,minor

Character special file, major number, minor number. Each character special file has a device major number, which identifies the device type, and a device minor number, which identifies a specific device of a given device type.

direct blocks

The block numbers of the first eight 8K blocks.

indirect blocks

The block numbers of the level 0, level 1 and level 2 trees.

mtime

Last modification time.

atime

Last access time.

ctime

Last change time.

create time

Create time.

reftime

Last reference time.

If the -localonly option is specified, the following fields are displayed:

vnode,vntok

Addresses of the ZFS vnode and the z/OS UNIX vnode.

opens

ow: Number of tasks that are waiting to open due to deny mode opens
oi: Number of internal opens
rd: Number of read opens
rw: Number of write opens

open deny

rd: Number of deny-read opens
wr: Number of deny-write opens
ar: Number of advisory deny-read opens
aw: Number of advisory deny-write opens

owner

zFS owning system.

file seq read

Indicates if user file cache considers file to be read sequentially. Valid only for files.

file seq write

Indicates if user file cache considers file to be written sequentially. Valid only for files.

file unscheduled

Indicates the number of unscheduled pages (dirty data) in the user file cache for files.

file segments

The number of 64-K segments of the file that is cached in the user file cache.

file dirty segments

The number of dirty segments in the user file cache. Dirty segments are regions of the file that are either dirty and not yet written to disk, or are waiting for an I/O to disk to complete.

file meta issued

Applicable to files or directories that were accessed by the sysplex client. It indicates if the client made a request recently to the server where the object's metadata was updated.

file meta pending

Applicable to files or directories that are accessed by sysplex client. It indicates if the client has an outstanding request to the server where the object's metadata might be updated.

client cached fsp

Indicates that the client has security information that is cached for the directory or file.

client cached anode

Indicates that the client has the object's attributes and location information for the directory or file.

client cached symlink

Indicates that the content of a symbolic link was cached by the sysplex client. This flag is valid only for symbolic links.

client revoke

Indicates if a revoke is in progress to this sysplex client for this file or directory.

client thrashing

Indicates if the file or directory is considered thrashing by zFS, and as a result, uses the zFS thrash resolution interface to the server.

client token rights

Indicates the token rights that are held by the sysplex client for the object.

client thrash ops

Number of forwarded requests.

client ops to server

Number of requests that the client made to the server for this object.

client meta buffers

Number of buffers in the metadata or backing cache for this object for the sysplex client.

client meta updates

Indicates whether the sysplex client has updated metadata for this object.

dirty meta buffers

For owners, indicates the number of dirty buffers in the metadata cache for this file or directory.

Privilege required

If you are using an IOEFSPRM file in your zFS PROC, the issuer must have READ authority to the data set that contains the IOEFSPRM file. If you are using parmlib (IOEPRMxx), the issuer does not need special authorization.

The issuer must have lookup authority (x) to the directory and READ authority (r) to the file.

Examples

The following example displays information for the /service9 directory:

zfsadm fileinfo -both /service9
   path: /service9
   ***   global data   ***
   fid                    1,1           anode                  69,516          
   length                 8192          format                 BLOCKED         
   1K blocks              8             permissions            755
   uid,gid                0,10          access acl             0,0             
   dir model acl          0,0           file model acl         0,0             
   user audit             F,F,F         auditor audit          N,N,N
   set sticky,uid,gid     0,0,0         seclabel               none
   object type            DIR           object linkcount       2               
   object genvalue        0x00000000    dir version            4               
   dir name count         na            dir data version       0               
   dir tree status        na            dir conversion         na              
   file format bits       na,na,na      file charset id        na              
   file cver              na            charspec major,minor   na              
   direct blocks          107          
   indirect blocks        none         
   mtime       Jun 13 10:41:43 2012   atime        Jun 13 10:41:43 2012
   ctime       Jun 13 10:41:43 2012   create time  Jun 13 10:41:43 2012
   reftime     none
   ***   local data from system DCEIMGVM   ***
   vnode,vntok          0x00000000,,0x794C0900      0x00FF7CA0,,0x00000000
   opens                ow=0          oi=0          rd=0          wr=0
   open deny            rd=0          wr=0          ar=0          aw=0
   owner                DCEIMGVM   file seq read           na          
   file seq write       na         file unscheduled        na          
   file pending         na         file segments           na          
   file dirty segments  na         file meta issued        na          
   file meta pending    na         client cached fsp       na          
   client cached anode  na         client cached symlink   na          
   client revoke        na         client thrashing        na          
   client token rights  na         client thrash ops       na          
   client ops to server na         client meta buffers     na          
   client meta updates  na         dirty meta buffers      0

Related information

None.