parrot_locate1

Usage

Overview

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

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