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 actually stored plus any additional 
    primary or backbone sites.  With the -v option, it lists every site 
    where a replicated file has an entry defined.  Whether the file is 
    actually stored there or not depends on the replicated storage attribute 
    of the file (fstore).

  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