glite-catalog-ls — List the contents of a directory in the catalog
glite-catalog-ls [ -h ] [ -q ] [ -s SERVICE ] [ -V ] [ -v ] [ -c ] [ -d ] [ -g ] [ -l ] [ -R ] [ -S ] [ -t ] [ -u ] [ -x ] LFN...
glite-catalog-ls is a command-line tool for listing directory contents. If LFN refers to a file, the file itself is listed. If LFN refers to a directory, the contets of that directory is listed (except if the -d is used). Without the -l option, only the LFNs are printed, one in a line. If -l is given, lines of output contain the following elements:
A letter showing the type of the entry: '-' for regular files, 'd' for directories, 'l' for symbolic links and 'v' for virtual directories.
The user, group and other permissions. See glite-catalog-chmod(1) for the description of the permission bits.
The letter '+' if the entry has extended ACLs.
The size of the file in human-readable format. Suffix 'k' stands for kiB (2^10), 'M' for MiB (2^20), 'G' for GiB (2^30), 'T' for TiB (2^40), 'P' for PiB (2^50) and 'E' for EiB (2^60).
The time the LFN was last modified.
The GUID if the -g flag was specified.
The listed LFN.
In case of symlinks, the name of the pointed file.
Print a short help message on parameters and usage, and exit.
Quiet operation.
Specifies the service endpoint to use. If SERVICE starts with http://, https:// or httpg://, then it is taken as a direct service endpoint URL. Otherwise SERVICE is taken as a service instance name and Service Discovery is invoked to look up the endpoint.
If this option is not specified, Service Discovery will be invoked and the first available catalog will be used. If the Service Discovery fails, the program will exit with an error.
If this option is not specified, only services with a known good status will be returned by Service Discovery. However if you explicitely specify a service name or an endpoint, the tool will try to use it regardless of its registered status.
If you specify an HTTP URL with an empty host name, the tool will dump the SOAP requests to the standard output and will read the SOAP reply from stdin.
Increases the verbosity level.
Print the version number and exit.
Without -l: sort by creation time. With -l: show creation time, but sort by name. With -lt: show and sort by creation time.
If an LFN given on the command line refers to a directory, list the directory node itself instead of its contents.
Also print GUIDs in the long listing.
Request long output.
Request recursive listing.
Sort by file size.
Sort by modification time, unless option -c or -x is also specified.
Do not sort the output. You may need this option if there is not enough memory to hold the sorted list of entries.
Without -l: sort by validity time. With -l: show validity time, but sort by name. With -lt: show and sort by validity time.
Name of the files and/or directories to list. The following URI formats are recognized:
LFN - Logical File Name. It can be either <path> or lfn://<path>. <path> must be absolute and must start with a slash (/). <path> may contain wildcards (? meaning any character and * meaning any string). Wildcards may appear at any part of the path, so you can specify constructs like /*/*/foo meaning every file named foo in any subdirecory two levels below the root directory.
GUID - Globally Unique Identifier. It must be given in the form of guid://<GUID>. The LFN belonging to the GUID will be looked up in the catalog and used for subsequent operations. GUID must have the form XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX, where every X means a hexadecimal digit.
SURL - Storage URL. This is an URL of the form srm://<path>. The tool will look up the LFN for which the SURL is registered as a replica and will use that LFN for subsequent operations.
Specifies the type of the Fireman catlog service to use during service discovery. The default value is org.glite.FiremanCatalog.
Specifies the type of the Storage Element Index service to use during service discovery. The default value is org.glite.SEIndex.
Specifies the type of the Metadata service to use during service discovery. The default value is org.glite.Metadata.