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