WHERE(1t,C) AIX Commands Reference WHERE(1t,C)
-------------------------------------------------------------------------------
where
PURPOSE
Displays file storage locations.
SYNTAX
+--------+ +-----+
where ---| +---+ |--| |--- file ---|
+-|-v |--+ +- - -+ ^ |
^|-p || +--------+
|+---+|
+-----+
DESCRIPTION
The where command takes a list of files and prints each name, status
information, and a list of the sites or CPU types where the file is stored.
There are three types of file systems with different output for each:
1. For files in non-replicated file systems, a single site name is listed.
2. Without the -v (verbose) option, files in system-replicated file systems
show site types where the files are stored plus any additional primary or
backbone sites. With the -v option, all storage sites are listed
vertically under the file information.
3. Files in user-replicated file systems always have storage sites displayed
vertically.
The first column of output lists status information about the file. The format
is:
[nr|sr|ur] [m|r|e|?|x]
where the flags have the following meanings:
nr File stored in a non-replicated file system.
sr File stored in a system-replicated file system.
ur File stored in a user-replicated file system.
m File exists and is modifiable (subject to permissions).
r File exists and is read-only (subject to permissions).
e File exists but no copy of it is available.
? File may exist but is unavailable due to unmounted file system or
unavailable storage site.
Processed November 8, 1990 WHERE(1t,C) 1
WHERE(1t,C) AIX Commands Reference WHERE(1t,C)
x File does not exist. This information is returned only if the -p flag is
used.
The next column of output is the file name, which the where command converts to
an absolute path if necessary. When a file does not exist or is unavailable
and contains symbolic links, where returns a name different than the one
specified even if it is given as an absolute path. Under these circumstances,
where prints an expanded path name using the contents of the symbolic links;
that is, it is an absolute path name where no available component of the path
is a symbolic link. For example, if /u is a symbolic link to /uy, /uy/user is
returned for /u/user.
The file name can have a "[SYM]" after it if the final component of the file
path is a symbolic link. Symbolic links in the last component are not
followed. Also, a "[MP]" can follow the path name if the named directory is
the mount point for a file system.
For system-replicated or non-replicated files, the last column of output is the
comma-separated list of sites and CPU types. For user-replicated files or
system-replicated files with the -v flag on, the sites are printed one per line
below the file name. Information about sites that are not in the current
partition or file systems that are not mounted is marked with a trailing
question mark.
Device files indicate the storage sites for their inodes, not necessarily where
the the device is attached. See "ls, lf, lr" for more information.
Note: The where command is sensitive to incorrect information in the
/etc/fsmap file, particularly disk flags.
FLAGS
-p Lists potential storage sites for files. The where command permits you
to specify non-existent files only if you use this option.
-v Verbose option; besides listing sites, displays site number and, for
replicated file systems, indicates whether a site is primary (pr) or
backbone (bb).
- Signals that the next argument is a file name beginning with a -.
FILES
/etc/site Contains site number/site name correspondences.
/etc/fsmap
Searched for information on file systems of site which down.
/etc/fstore
Contains fstore/cpu name correspondences.
RELATED INFORMATION
See the following commands: "ls, lf, lr," "store," and "chfstore."
Processed November 8, 1990 WHERE(1t,C) 2
WHERE(1t,C) AIX Commands Reference WHERE(1t,C)
See fsmap, fstore, fs, site, dustatd and symlink in the AIX Operating System
Technical Reference.
Processed November 8, 1990 WHERE(1t,C) 3