1globus-rls-cli(1) General Commands Manual globus-rls-cli(1)
2
6 globus-rls-cli - Globus Replica Location Service Command Line Interface
7
9 globus-rls-cli command [ -c ] [ -d ] [ -h ] [ -i inputfile ] [ -l
10 reslimit ] [ -s ] [ -t timeout ] [ -u ] [ command ] rls-server
11
13 globus-rls-cli provides a command line interface to some of the func‐
14 tions supported by the Globus Replica Location service. It also sup‐
15 ports an interactive interface (if command is not specified). In
16 interactive move double quotes may be used to encode an argument that
17 contains white space.
18
20 globus-rls-cli uses getopt(3) to do command line parsing. Some ver‐
21 sions will continue scanning for options (works that begin with a
22 hyphen) for the entire command, line, which makes it impossible to
23 specify negative integer or floating point value for an attribute. The
24 workaround for this problem is to tell getopt() that there are no more
25 options, by including 2 hyphens, eg to specify the value "-2" enter "--
26 -2".
27 -c Set "clearvalues" flag when deleting an attribute (will remove
29 any attribute value records when an attribute is deleted).
30 -d Decorate the output. By default the output is presented without
32 decorations. Using this option restores decorations in the
33 original style.
34 -h Show usage.
36 -i inputfile
38 Read bulk input parameters from the input file. Each row of the
39 input file corresponds to an individual operation of the com‐
40 mand. If inputfile is replaced with '-' input parameters will be
41 read from stdin.
42 -l reslimit
44 Set limit on number of results returned by wildcard query at a
45 time. Zero means no limit.
46 -s Use SQL style wildcards (% and _).
48 -t timeout
50 Set timeout (in seconds) for RLS server requests. Default is 30
51 seconds.
52 -u Use Unix style wildcards (* and ?).
54 -v Show version.
56
58 add <lfn> <pfn>
59 Add pfn to mappings of lfn in an LRC catalog.
60 attribute add <object> <attr> <obj-type> <attr-type> <value>
62 Add an attribute to an object, object should be the lfn or pfn
63 name. obj-type should be one of lfn or pfn. attr-type should
64 be one of date, float int, or string. If <value> is of type
65 date then it should be in the form "YYYY-MM-DD HH:MM:DD".
66 attribute bulk add <object> <attr> <obj-type> <attr-type> <val> ...
68 Bulk add attribute values.
69 attribute bulk delete <object> <attr> <obj-type> ...
71 Bulk delete attributes.
72 attribute bulk query <attr> <obj-type> <object> ...
74 Bulk query attributes.
75 attribute define <attr> <obj-type> <attr-type>
77 Define new attribute.
78 attribute delete <object> <attr> <obj-type>
80 Remove attribute from object.
81 attribute modify <object> <attr> <obj-type> <attr-type> <new value>
83 Modify the value of an attribute.
84 attribute query <object> <attr> <obj-type>
86 Retrieve value of specified attribute for object.
87 attribute search <attr> <obj-type> <operator> <attr-type> <value>
89 Search for objects which have the specified attribute matching
90 operator and value. operator should be one of =, !=, >, >=, <,
91 <=, like.
92 attribute show <attr> <obj-type>
94 Show attribute definition. If attr is a hypen (-) then all
95 attributes are shown.
96 attribute undefine <attr> <obj-type>
98 Delete an attribute definition. Will return an error if any
99 objects possess this attribute.
100 bulk add <lfn> <pfn> [<lfn> <pfn> ...]
102 Bulk add lfn, pfn mappings.
103 bulk create <lfn> <pfn> [<lfn> <pfn> ...]
105 Bulk create lfn, pfn mappings.
106 bulk delete <lfn> <pfn> [<lfn> <pfn> ...]
108 Bulk delete lfn, pfn mappings.
109 bulk exists lrc lfn showall|showexists|shownotexists [<lfn> ...]
111 Bulk exists lrc for lfns.
112 bulk exists lrc pfn showall|showexists|shownotexists [<pfn> ...]
114 Bulk exists lrc for pfns.
115 bulk exists rli lfn showall|showexists|shownotexists [<lfn> ...]
117 Bulk exists rli for lfns.
118 bulk query lrc lfn [<lfn> ...]
120 Bulk query lrc for lfns.
121 bulk query lrc pfn [<pfn> ...]
123 Bulk query lrc for pfns.
124 bulk query rli lfn [<lfn> ...]
126 Bulk query rli for lfns.
127 bulk rename lrc lfn <lfn> <newname> [<lfn> <newname> ...]
129 Bulk rename lfns in an LRC server. First lfn identifies original
130 lfn, which must exist. Second newname identifies new lfn name,
131 which must not exist. When immediate mode is on, the LRC will
132 update the RLI with the changes.
133 bulk rename lrc pfn <pfn> <newname> [<pfn> <newname> ...]
135 Bulk rename pfns in an LRC server. First pfn identifies original
136 pfn, which must exist. Second newname identifies new pfn name,
137 which must not exist.
138 create <lfn> <pfn>
140 Create a new lfn, pfn mapping in an LRC catalog.
141 delete <lfn> <pfn>
143 Delete a lfn, pfn mapping from an LRC catalog.
144 exists lrc lfn <lfn>
146 Check an LRC server for existence of lfn.
147 exists lrc pfn <pfn>
149 Check an LRC server for existence of pfn.
150 exists rli lfn <lfn>
152 Check an RLI server for existence of lfn.
153 exit Exit interactive session.
155 help Print help message.
157 query lrc lfn <lfn>
159 Query an LRC server for mappings of lfn.
160 query lrc pfn <pfn>
162 Query an LRC server for mappings to pfn.
163 query rli lfn <lfn>
165 Query an RLI server for mappings of lfn.
166 query wildcard lrc lfn <lfn-pattern>
168 Perform a wildcarded query of an LRC server for mappings of lfn-
169 pattern. Patterns use the standard Unix wildcard characters, an
170 asterisk (*) matches 0 or more characters, and a question mark
171 (?) matches any single character.
172 query wildcard lrc pfn <pfn-pattern>
174 Query an LRC server for mappings to pfn-pattern. Patterns use
175 the standard Unix wildcard characters, an asterisk (*) matches 0
176 or more characters, and a question mark (?) matches any single
177 character.
178 query wildcard rli lfn <lfn-pattern>
180 Query an RLI server for mappings of lfn-pattern. Patterns use
181 the standard Unix wildcard characters, an asterisk (*) matches 0
182 or more characters, and a question mark (?) matches any single
183 character.
184 rename lrc lfn <lfn> <newname>
186 Rename a lfn in an LRC server. First lfn identifies original
187 lfn, which must exist. Second newname identifies new lfn name,
188 which must not exist. When immediate mode is on, the LRC will
189 update the RLI with the change.
190 rename lrc pfn <pfn> <newname>
192 Rename a pfn in an LRC server. First pfn identifies original
193 pfn, which must exist. Second newname identifies new pfn name,
194 which must not exist.
195 set reslimit <limit>
197 Set limit on number of results returned at a time by a wildcard
198 query. Zero means no limit.
199 set timeout <timeout>
201 Set timeout on calls to the RLS server. The default is 30 sec‐
202 onds.
203 version
205 Show version and exit.
206
208 globus-rls-server(8), globus_rls_client man pages
209 29 Aug 02 globus-rls-cli(1)