NAME
parrot_locate - provides the true location of the data stored in a named file.
SYNOPSIS
FCparrot_locate pathFT
DESCRIPTION
FCparrot_locateFT utilises parrot system calls to identify where the data stored as the file at FC<path>FT is actually located. For example, running FCparrot_locateFT 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 FCparrot_locateFT varies depending on the underlying system. Most systems return output in the form "FC<server>:<real path>FT", but that output is not guaranteed.
OPTIONS
FCparrot_locateFT has no options.
ENVIRONMENT VARIABLES
Environment variables required by FCparrot_locateFT 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