parrot_locate - provides the true location of the data stored in a named file.
Contents
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.
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>:<realpath>", but that output is not guaranteed.
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.
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
Exit Status
On success, returns zero. On failure, returns non-zero.
Name
parrot_locate - provides the true location of the data stored in a named file.
Options
parrot_locate has no options.
See Also
• CooperativeComputingToolsDocumentation
• ParrotUserManual
• 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_pack‐age_create(1)parrot_package_run(1)chroot_package_run(1)
CCTools 7.14.5 FINAL parrot_locate(1)
Synopsis
parrot_locate path
