ginfo (1) - Linux Manuals

ginfo: fetch service information

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>