.TH "parrot_locate" 1 "" "CCTools 7.1.2 FINAL" "Cooperative Computing Tools"

.SH NAME
.LP
\fBparrot_locate\fP - provides the true location of the data stored in a named file.

.SH SYNOPSIS
.LP
\FC\fBparrot_locate path\fP\FT

.SH DESCRIPTION
.LP

\FCparrot_locate\FT utilises \fBparrot\fP system calls to identify where the data stored as the file
at \FC<path>\FT is actually located.  For example, running \FCparrot_locate\FT on a file stored in a
\fBchirp\fP multi-volume will return the server name and file path on the server where the data is.
Running it on a file stored in \fBhdfs\fP will return the list of chunk servers storing the file.
.PP
Note that \FCparrot_locate\FT varies depending on the underlying system.  Most systems return output
in the form "\FC<server>:<real path>\FT", but that output is not guaranteed.


.SH OPTIONS
.LP

\FCparrot_locate\FT has no options.


.SH ENVIRONMENT VARIABLES
.LP
Environment variables required by \FCparrot_locate\FT are system dependent.
Most systems do not use or require any.  Refer to the specific system's documentation
for more information.


.SH EXIT STATUS
.LP
On success, returns zero.  On failure, returns non-zero.

.SH EXAMPLES
.LP

To check the location of a file stored in chirp:

.fam C
.nf
.nh
.IP "" 8
% parrot_run parrot_locate /chirp/server.nd.edu/joe/data
	server.nd.edu:/chirp/server.nd.edu/joe/data
.fi
.hy
.fam
.P

or a file stored in a chirp multi-volume

.fam C
.nf
.nh
.IP "" 8
% parrot_run parrot_locate /multi/server.nd.edu@multivol/data
	datastore01.nd.edu:multivol/data/ttmtteotsznxewoj
.fi
.hy
.fam
.P

.SH COPYRIGHT
.LP

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.

.SH SEE ALSO
.LP


.IP \(bu 4
\fBCooperative Computing Tools Documentation\fP
.IP \(bu 4
\fBParrot User Manual\fP
.IP \(bu 4
\fBparrot_run(1)\fP \fBparrot_cp(1)\fP \fBparrot_getacl(1)\fP  \fBparrot_setacl(1)\fP  \fBparrot_mkalloc(1)\fP  \fBparrot_lsalloc(1)\fP  \fBparrot_locate(1)\fP  \fBparrot_timeout(1)\fP  \fBparrot_whoami(1)\fP  \fBparrot_mount(1)\fP  \fBparrot_md5(1)\fP  \fBparrot_package_create(1)\fP  \fBparrot_package_run(1)\fP  \fBchroot_package_run(1)\fP