NAME

       parrot_locate - provides the true location of the data stored in a named file.

SYNOPSIS

       parrot_locate path

DESCRIPTION

       parrot_locate  utilises  parrot system calls to identify where the data stored as the file
       at <path> is actually located.  For example, running parrot_locate on a file stored  in  a
       chirp  multi-volume will return the server name and file path on the server where the data
       is.  Running it on a file stored in hdfs will return the list of chunk servers storing the
       file.

       Note  that  parrot_locate  varies depending on the underlying system.  Most systems return
       output in the form "<server>:<real path>", but that output is not guaranteed.

OPTIONS

       parrot_locate has no options.

ENVIRONMENT VARIABLES

       Environment variables required by parrot_locate are system dependent.  Most systems do not
       use or require any.  Refer to the specific system's documentation for more information.

EXIT STATUS

       On success, returns zero.  On failure, returns non-zero.

EXAMPLES

       To check the location of a file stored in chirp:

               % parrot_run parrot_locate /chirp/server.nd.edu/joe/data
                    server.nd.edu:/chirp/server.nd.edu/joe/data

       or a file stored in a chirp multi-volume

               % parrot_run parrot_locate /multi/server.nd.edu@multivol/data
                    datastore01.nd.edu:multivol/data/ttmtteotsznxewoj

COPYRIGHT

       The Cooperative Computing Tools are Copyright (C) 2022 The University of Notre Dame.  This
       software is distributed under the GNU General Public License.  See the  file  COPYING  for
       details.

SEE ALSO

       •   Cooperative Computing Tools Documentation

       •   Parrot User Manual

       •   parrot_run(1)   parrot_cp(1)   parrot_getacl(1)   parrot_setacl(1)   parrot_mkalloc(1)
           parrot_lsalloc(1)      parrot_locate(1)       parrot_timeout(1)       parrot_whoami(1)
           parrot_mount(1)     parrot_md5(1)    parrot_package_create(1)    parrot_package_run(1)
           chroot_package_run(1)