PreviousNext

hostdata show

Returns an attribute list of the hostdata entries specified in the argument. The syntax is:

hostdata show hostdata_name_list
[-ifname residual_object_name | [-entry] [-binary] [-local] [-unauth]

Options

-ifname
Specifies the dced object for which to return the value.

-entry
Only the configuration information that dced keeps is deleted, not the actual hostdata.

-binary
Specifies to return the value of the data attribute in binary form.

-local
Specifies that the command should operate on the local dced hostdata object while the dced object is in a partial-service state.

-unauth
Specifies that the command should operate as if an unauthenticated user is running it. This option is useful for intercell access when the cell registries are not connected.

Description
The hostdata_name_list argument is a list of names of hostdata entries. If called with the -entry option, the data attribute is not returned. The -binary option can be specified to indicate that the value of the data attribute should be returned in binary form. If the argument is a list the output is concatenated into a single list in the order specified. The ifname option is used to identify the specific hostdata entry to show, but only when the argument is a string binding representing a host, not the fully qualified hostdata name.

Privileges Required
You must have r (read) permission to the hostdata container on the host (/.:/hosts/host_name/config/hostdata/hostdata_container).

Examples

dcecp> hostdata show /.:/hosts/mars/config/hostdata/cell_name
{uuid 00174f6c-6eca-1d6a-bf90-0000c09ce054}
{annotation {Name of cell}}
{storage cell_name}
{hostdata/data /.../my_cell}
dcecp>

dcecp> hostdata show ncacn_ip_tcp:15:122:24.148 -ifname cell_name
{uuid 00174f6c-1d6a-bf90-0000c09ce054}
{annotation {Name of cell}}
{storage cell_name}
{hostdata/data /. . ./my_cell}
dcecp>