cm whereis(8dfs)

Synopsis

cm whereis [-path {filename | directory_name}...] [-help]

Options

-path filename or directory_name
Specifies the path name of each file or directory whose location is to be reported. Each file or directory must reside in DFS, not on a local disk. If a full path name is not provided, the file or directory is assumed to reside in the current working directory. If this option is omitted, the current working directory is used.

-help
Prints the online help for this command. All other valid options specified with this option are ignored.

Description
The cm whereis command displays information about the location of each file or directory indicated with the -path option. The command reports the name of the cell in which the file or directory exists, the name of the fileset in which it resides, and the name of each File Server machine that houses a copy of the fileset. This information comes from the kernel of the workstation on which the command is issued.

Privilege Required
No privileges are required.

Output
The output includes a separate line displaying the following information about each file or directory specified with the -path option:

File 'filename' resides in the cell 'cellname' in fileset

'fileset_name' on host(s) 'hostname'.

In the output

filename
Specifies the complete path name of a file or directory specified with the -path option.

cellname
Specifies the name of the cell in which the file or directory is located.

fileset_name
Specifies the name of the fileset in which the file or directory is located.

hostname
Specifies the name of the File Server machine on which the fileset is located. If the fileset is a read/write or backup fileset, only one machine name is displayed; if the fileset is a read-only fileset, multiple machine names can be displayed. However, only one machine name is displayed for each File Server machine. (The Cache Manager can have up to four preferences for each file Server machine, with each preference having a different host name or IP address.)

Examples
The following command indicates that the directory named /.../abc.com/fs/bin/sysfile is located in a replicated fileset on the File Server machines named fs1, fs3, and fs6, all of which are located in the cell named abc.com:

$ cm whereis /.../abc.com/fs/bin/sysfile

File '/.../abc.com/fs/bin/sysfile' resides in the cell 'abc.com',

in fileset 'sysfile.bin', on hosts fs1.abc.com, fs3.abc.com,

fs6.abc.com.

Related Information
Commands: cm statservers(8dfs)