DOKK / manpages / debian 10 / coop-computing-tools / parrot_locate.1.en
parrot_locate(1) Cooperative Computing Tools parrot_locate(1)

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

parrot_locate path

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.

parrot_locate has no options.

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.

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

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

The Cooperative Computing Tools are Copyright (C) 2003-2004 Douglas Thain and Copyright (C) 2005-2015 The University of Notre Dame. This software is distributed under the GNU General Public License. See the file COPYING for details.

CCTools 7.0.9 FINAL