ginfo (1) - Linux Man Pages

ginfo: fetch service information

Command to display ginfo manual in Linux: $ man 1 ginfo

NAME

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>