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) 2005-2019 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)