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)