parrot_locate(1)

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 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 ":", 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