NAME
globus-rls-cli - Globus Replica Location Service Command Line Interface
SYNOPSIS
globus-rls-cli command [ -c ] [ -d ] [ -h ] [ -i inputfile ] [ -l
reslimit ] [ -s ] [ -t timeout ] [ -u ] [ command ] rls-server
DESCRIPTION
globus-rls-cli provides a command line interface to some of the
functions supported by the Globus Replica Location service. It also
supports an interactive interface (if command is not specified). In
interactive move double quotes may be used to encode an argument that
contains white space.
OPTIONS
globus-rls-cli uses getopt(3) to do command line parsing. Some
versions will continue scanning for options (works that begin with a
hyphen) for the entire command, line, which makes it impossible to
specify negative integer or floating point value for an attribute. The
workaround for this problem is to tell getopt() that there are no more
options, by including 2 hyphens, eg to specify the value "-2" enter "--
-2".
-c Set "clearvalues" flag when deleting an attribute (will remove
any attribute value records when an attribute is deleted).
-d Decorate the output. By default the output is presented without
decorations. Using this option restores decorations in the
original style.
-h Show usage.
-i inputfile
Read bulk input parameters from the input file. Each row of the
input file corresponds to an individual operation of the
command. If inputfile is replaced with ’-’ input parameters will
be read from stdin.
-l reslimit
Set limit on number of results returned by wildcard query at a
time. Zero means no limit.
-s Use SQL style wildcards (% and _).
-t timeout
Set timeout (in seconds) for RLS server requests. Default is 30
seconds.
-u Use Unix style wildcards (* and ?).
-v Show version.
COMMANDS
add <lfn> <pfn>
Add pfn to mappings of lfn in an LRC catalog.
attribute add <object> <attr> <obj-type> <attr-type> <value>
Add an attribute to an object, object should be the lfn or pfn
name. obj-type should be one of lfn or pfn. attr-type should
be one of date, float int, or string. If <value> is of type
date then it should be in the form "YYYY-MM-DD HH:MM:DD".
attribute bulk add <object> <attr> <obj-type> <attr-type> <val> ...
Bulk add attribute values.
attribute bulk delete <object> <attr> <obj-type> ...
Bulk delete attributes.
attribute bulk query <attr> <obj-type> <object> ...
Bulk query attributes.
attribute define <attr> <obj-type> <attr-type>
Define new attribute.
attribute delete <object> <attr> <obj-type>
Remove attribute from object.
attribute modify <object> <attr> <obj-type> <attr-type> <new value>
Modify the value of an attribute.
attribute query <object> <attr> <obj-type>
Retrieve value of specified attribute for object.
attribute search <attr> <obj-type> <operator> <attr-type> <value>
Search for objects which have the specified attribute matching
operator and value. operator should be one of =, !=, >, >=, <,
<=, like.
attribute show <attr> <obj-type>
Show attribute definition. If attr is a hypen (-) then all
attributes are shown.
attribute undefine <attr> <obj-type>
Delete an attribute definition. Will return an error if any
objects possess this attribute.
bulk add <lfn> <pfn> [<lfn> <pfn> ...]
Bulk add lfn, pfn mappings.
bulk create <lfn> <pfn> [<lfn> <pfn> ...]
Bulk create lfn, pfn mappings.
bulk delete <lfn> <pfn> [<lfn> <pfn> ...]
Bulk delete lfn, pfn mappings.
bulk exists lrc lfn showall|showexists|shownotexists [<lfn> ...]
Bulk exists lrc for lfns.
bulk exists lrc pfn showall|showexists|shownotexists [<pfn> ...]
Bulk exists lrc for pfns.
bulk exists rli lfn showall|showexists|shownotexists [<lfn> ...]
Bulk exists rli for lfns.
bulk query lrc lfn [<lfn> ...]
Bulk query lrc for lfns.
bulk query lrc pfn [<pfn> ...]
Bulk query lrc for pfns.
bulk query rli lfn [<lfn> ...]
Bulk query rli for lfns.
bulk rename lrc lfn <lfn> <newname> [<lfn> <newname> ...]
Bulk rename lfns in an LRC server. First lfn identifies original
lfn, which must exist. Second newname identifies new lfn name,
which must not exist. When immediate mode is on, the LRC will
update the RLI with the changes.
bulk rename lrc pfn <pfn> <newname> [<pfn> <newname> ...]
Bulk rename pfns in an LRC server. First pfn identifies original
pfn, which must exist. Second newname identifies new pfn name,
which must not exist.
create <lfn> <pfn>
Create a new lfn, pfn mapping in an LRC catalog.
delete <lfn> <pfn>
Delete a lfn, pfn mapping from an LRC catalog.
exists lrc lfn <lfn>
Check an LRC server for existence of lfn.
exists lrc pfn <pfn>
Check an LRC server for existence of pfn.
exists rli lfn <lfn>
Check an RLI server for existence of lfn.
exit Exit interactive session.
help Print help message.
query lrc lfn <lfn>
Query an LRC server for mappings of lfn.
query lrc pfn <pfn>
Query an LRC server for mappings to pfn.
query rli lfn <lfn>
Query an RLI server for mappings of lfn.
query wildcard lrc lfn <lfn-pattern>
Perform a wildcarded query of an LRC server for mappings of lfn-
pattern. Patterns use the standard Unix wildcard characters, an
asterisk (*) matches 0 or more characters, and a question mark
(?) matches any single character.
query wildcard lrc pfn <pfn-pattern>
Query an LRC server for mappings to pfn-pattern. Patterns use
the standard Unix wildcard characters, an asterisk (*) matches 0
or more characters, and a question mark (?) matches any single
character.
query wildcard rli lfn <lfn-pattern>
Query an RLI server for mappings of lfn-pattern. Patterns use
the standard Unix wildcard characters, an asterisk (*) matches 0
or more characters, and a question mark (?) matches any single
character.
rename lrc lfn <lfn> <newname>
Rename a lfn in an LRC server. First lfn identifies original
lfn, which must exist. Second newname identifies new lfn name,
which must not exist. When immediate mode is on, the LRC will
update the RLI with the change.
rename lrc pfn <pfn> <newname>
Rename a pfn in an LRC server. First pfn identifies original
pfn, which must exist. Second newname identifies new pfn name,
which must not exist.
set reslimit <limit>
Set limit on number of results returned at a time by a wildcard
query. Zero means no limit.
set timeout <timeout>
Set timeout on calls to the RLS server. The default is 30
seconds.
version
Show version and exit.
SEEL ALSO
globus-rls-server(8), globus_rls_client man pages
29 Aug 02 globus-rls-cli(1)