ginfo man page

ginfo — fetch service information

Synopsis

ginfo [options] Object [attribute_to_filter='value of the attribute'] [attribute_to_display]

Description

List attributes corresponding to an object. By default, all the attributes of an object are displayed.

Options

-H, --host host
Specify a host to query. By default the environmental variable LCG_GFAL_INFOSYS will be used.
-b, --bind binding
Specify the binding (o=glue by default).
-l, --list attribute
List all the possible values of the specified attribute.
-c, --csv
Output in CSV formating
-j, --json
Output in JSON formating
-t, --timeout
Change the ldap timeout (15 seconds by default).
-v, --verbose
Enable verbose mode
-V, --version
Print the version of ginfo
-h, --help
Print this helpful message

Objects and Corresponding Attributes

AdminDomain:
ID, Description.
ComputingManager:
ID, ProductName, ProductVersion, ServiceID.
ComputingShare:
ID, MaxCPUTime, MaxWallTime, ServingState, ExecutionEnvironmentForeignKey, RunningJobs, WaitingJobs.
Endpoint:
ID, URL, Capability, InterfaceName, InterfaceVersion, Implementor, ImplementationVersion, QualityLevel, HealthState, ServingState, ServiceForeignKey.
ExecutionEnvironment:
ID, OSName, ConnectivityOut, MainMemorySize, VirtualMemorySize.
Location:
ID, Country, Latitude, Longitude.
MappingPolicy:
ID, Scheme, Rule, ComputingShareID.
Service:
ID, Capability, Type, QualityLevel, StatusInfo, AdminDomainID.
StorageShare:
ID, Path, AccessMode, AccessLatency, ServingState, RetentionPolicy, ExpirationMode, DefaultLifeTime, MaximumLifeTime, Tag.

Output Format

Standard output for an Endpoint:
HealthState: Value
Implementor: Value
InterfaceName: Value
ServingState: Value
URL: Value
ImplementationVersion: Value
Capability: Value
ServiceForeignKey: Value
QualityLevel: Value
ID: Value
InterfaceVersion: Value

JSON output for an Endpoint:
[... "Value_of_the_ID": {
"HealthState": Value,
"Implementor": Value,
"InterfaceName": Value,
"ServingState": Value,
"URL": Value,
"ImplementationVersion": Value,
"Capability": Value,
"ServiceForeignKey": Value,
"QualityLevel": Value,
"ID": Value,
"InterfaceVersion": Value}, ...]

CSV output for an Endpoint:
HealthState,Implementor,InterfaceName,ServingState,URL,
ImplementationVersion,Capability,ServiceForeignKey,QualityLevel,
ID,InterfaceVersion

Examples

1) List all information for all Endpoint attributes
ginfo --host bdii.example.com Endpoint
2) Use the host from the LCG_GFAL_INFOSYS environment variable and list all Location countries
export LCG_GFAL_INFOSYS=bdii.example.com:2170
ginfo Location country
3) List all the Service types
ginfo -l Type Service
4) List all IDs from Endpoint which have 'org.glite.FileTransfer' as name of Interface
ginfo Endpoint InterfaceName=org.glite.FileTransfer ID
5) Show the version too
ginfo Endpoint InterfaceName=org.glite.FileTransfer ID InterfaceVersion
6) Show all available information about these Endpoints
ginfo Endpoint InterfaceName=org.glite.FileTransfer
7) Export to CSV
ginfo --csv Endpoint InterfaceName=org.glite.FileTransfer

Author

Ivan Calvet <ivan.calvet at cern dot ch>

Info

SEPTEMBER 2013 Version 1.0.3 ginfo manual