<touch>
Purpose/Function
Touches files (UNIX-only). One or more URIs can be added. Alternatively, (existing) files can be touched by giving a UriPattern
, which will force an ls-
operation first.
Attributes
NAME |
TYPE |
DEFAULT VALUE |
DESCRIPTION |
---|---|---|---|
cleanup |
|
true |
delete the cache(s) upon termination of the operation |
copyCache |
|
|
touch the target entries in this cache |
copyCacheFile |
|
|
touch the target entries in this cache |
includeAncestors |
|
false |
include all the ancestors of each URI |
listCache |
|
|
touch the entries in this cache |
listCacheFile |
|
|
touch the entries in this cache |
Listener control attributes
NAME |
TYPE |
DEFAULT VALUE |
DESCRIPTION |
---|---|---|---|
event |
|
true |
if listener is a |
log4j |
|
false |
if listener is a |
stdout |
|
false |
if listener is a |
Elements
TAG |
TYPE |
COUNT |
DESCRIPTION |
---|---|---|---|
|
|
0:1 |
configuration with additional non-default settings |
|
|
0:1 |
pattern pattern to use with ls-operation |
|
|
0:1 |
configuration with additional non-default settings |
Listener elements
TAG |
TYPE |
COUNT |
DESCRIPTION |
---|---|---|---|
|
|
0:N |
generic tag, must be used in conjunction with xmlns:absoluteTag namespace |
|
|
0:N |
built-in type; see listeners |
|
|
0:N |
built-in type; see listeners |
|
|
0:N |
built-in type; see listeners |
ReturnValues
DEFAULT NAME |
TYPE |
---|---|
touch |
|
NOTES
- For a given task, added URIs must all have the same scheme and endpoint.
- Cleanup defaults to true, so caches that are used will be deleted unless otherwise indicated. The operation is returned only if cleanup is false.
- If includeAncestors is true, the task forces mkdir on the ancestors of each
<uri>
element added. - It is possible to by-pass adding either URIs or a
UriPattern
by pointing the task at pre-existing caches, either as objects in the environment or as files. - Any additional settings passed in using the configuration object will be added to the default settings (the latter must be explicitly overridden if they are not desired).
- An
Ls-
operation done in conjunction with<touch>
by adding a<pattern>
will automatically set the list-recursive property to true.
Examples
<ogrescript> <touch> <uri>file:/tmp/dir0/file-0</uri> <uri>file:/tmp/dir0/file-1</uri> <uri>file:/tmp/dir0/file-2</uri> <uri>file:/tmp/dir0/file-3</uri> </touch> <touch> <pattern base="gsiscp://otfrid.ncsa.uiuc.edu/home/arossi"> <exclude>**/.*</exclude> </pattern> </touch> ... </ogrescript>