hostdata(1m)
NAME
hostdata - A dcecp object that manages a DCE host’s cell affiliation information
SYNOPSIS
hostdata catalog [host_name_list] [-simplename] [-local] hostdata create hostdata_name_list {-attribute attribute_list | -attribute value} [-binary] [-local] hostdata delete hostdata_name_list [-entry] [-local] hostdata help [operation | -verbose] hostdata modify hostdata_name_list {-change attribute_list | -attribute value} [-binary] [-local] hostdata operations hostdata show hostdata_name_list [-ifname residual_object_name | [-entry] [-binary]] [-local]
ARGUMENTS
hostdata_name_list
A list of one or more names of of host data items. Usually they are of the following form:
/.:/hosts/hostname/config/hostdata/name
For the show operation, the name can also be a single string binding representing the host with which to communicate. For example:
{ncacn_ip_tcp 130.105.1.227}
A string binding is useful when the name service is not operating and cannot translate the other forms of host data item names.
host_name_list
A list of one or more DCE host names specifying hosts for which to catalog servers. Host names can be in any of the following forms:
/.:/hosts/hostname
/.../cell_name/hosts/hostname
hosts/hostname
For the catalog operation, the name can also be a single string binding representing the host with which to communicate. See hostdata_name_list for more information. If you supply a single string binding, you must use the -ifname option to specify the host’s residual name.
operationThe name of the hostdata operation for which to display help information.
DESCRIPTION
The hostdata object represents a hostdata entry stored by dced on a host that represents some data, usually a file. The data in the hostdata object is represented by the hostdata/data attribute of the hostdata entry. Remote manipulation of data in the hostdata object is accomplished by the hostdata command. The names of these hostdata objects are in the DCE namespace and are controlled by dced. Usually they are of the following form:
/.:/hosts/hostname/config/hostdata/name
However, a shorthand notation referring to the local machine consisting of just name can be used in some circumstances. When the dced on the local machine is in partial service mode, you must use the -local option to access the hostdata object. To access the hostdata objects when dced is in partial service mode, specify only the residual portion of the object name. For example, specify hostdata, not /.:/hosts/gumby/config/hostdata.
ATTRIBUTES
uuid hexadecimal number
An internal identifier for the hostdata entry. Its value is a Universal Unique Identifier (UUID). If not specified on creation, one is generated by dcecp. This attribute cannot be modified after creation.
annotation string
A human readable comment field limited to Portable Character Set (PCS) data. It cannot be modified after creation. This attribute defaults to a null string (that is, blank).
storage stringA PCS string that identifies the name of the data repository. In the current release of dced, it is a filename. It is required and may not be modified after creation.
hostdata/data string
An attribute that represents the actual data. Its syntax is a list of strings. The data can be viewed and modified in two different modes, either as a string, or as binary data. By default the string mode is used, but some of the operations below accept a binary option to allow this attribute to be displayed or modified in binary form. When viewed as a string, each string in the list represents one line in the hostdata file.
See the OSF DCE Administration Guide for more information about hostdata attributes.
OPERATIONS
hostdata catalog
Returns a list of the names of all hostdata objects on the specified host. The syntax is as follows: hostdata catalog [host_name_list] [-simplename] [-local] Options
-simplenameReturns a list of hostdata entries without prepending the cell name and name of the hostdata container.
-localSpecifies that the command should operate on the local dced hostdata object while the dced object is in a partial-service state.
The catalog operation returns a list of the names of all hostdata objects on the specified host, in arbitrary order. The optional host_name_list argument is used to specify objects on a foreign host. By default, fully qualified names are returned. Use the -simplename option to return objects names without the prepended cellname and hostdata container names. 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 catalog
/.../gumby1/hosts/fire/config/hostdata/dce_cf.db
/.../gumby1/hosts/fire/config/hostdata/cell_name
/.../gumby1/hosts/fire/config/hostdata/pe_site
/.../gumby1/hosts/fire/config/hostdata/cds_attributes
/.../gumby1/hosts/fire/config/hostdata/cds_globalnames
/.../gumby1/hosts/fire/config/hostdata/host_name
/.../gumby1/hosts/fire/config/hostdata/cell_aliases
/.../gumby1/hosts/fire/config/hostdata/post_processors
/.../gumby1/hosts/fire/config/hostdata/svc_routing
/.../gumby1/hosts/fire/config/hostdata/krb.conf
/.../gumby1/hosts/fire/config/hostdata/dfs-cache-info
/.../gumby1/hosts/fire/config/hostdata/cds.conf
/.../gumby1/hosts/fire/config/hostdata/passwd_override
/.../gumby1/hosts/fire/config/hostdata/group_override
dcecp>
hostdata create
Creates a hostdata configuration object. The syntax is as follows: hostdata create hostdata_name_list {-attribute attribute_list | -attribute value} [-binary] [-local] Options
-attribute attribute_list
Allows you to specify attributes by using an attribute list rather than using the -attribute value option. The format of an attribute list is as follows:
{{attribute value}...{attribute value}}
-attribute value
As an alternative to using the -attribute option with an attribute list, you can specify individual attribute options by prepending a hyphen (-) to any attributes listed in the ATTRIBUTES section of this reference page.
-binarySpecifies that the value of the data attribute is in binary form.
-localSpecifies that the command should operate on the local dced hostdata object while the dced object is in a partial-service state.
The hostdata_name_list argument is a list of names of hostdata entries to be created. The -attributes option specifies configuration information for dced. The contents of the hostdata file can be specified via the data attribute. The value of the option is applied to all elements of the argument list. This operation returns an empty string on success. Privileges Required You must have w (write) permission to the hostdata container on the host. Examples
dcecp> hostdata create file1 -storage /tmp/file1 -data {{first line}}
dcecp>
dcecp> hostdata show file1
{uuid 8484188a-eb85-11cd-91b1-080009251352}
{annotation {}}
{storage /tmp/file1}
{hostdata/data {first line}}
dcecp>
dcecp> cat /tmp/file1
first line
dcecp>
hostdata delete
Deletes a hostdata entry and its data. The syntax is as follows: hostdata delete hostdata_name_list [-entry] [-local] Options
-entryOnly the configuration information that dced keeps is deleted, not the actual hostdata.
-localSpecifies that the command should operate on the local dced hostdata object while the dced object is in a partial-service state.
The hostdata_name_list argument is a list of names of hostdata entries to be deleted in the order specified. If the -entry option is present, only the configuration information that dced keeps is deleted, not the actual hostdata. This operation returns an empty string on success. Privileges Required You must have d (delete) permission to the hostdata container on the host. Examples
dcecp> hostdata delete file1
dcecp>
hostdata help
Returns help information about the hostdata object and its operations. The syntax is as follows: hostdata help [operation | -verbose] Options
-verboseDisplays information about the hostdata object.
Used without an argument or option, the hostdata help command returns brief information about each hostdata operation. The optional operation argument is the name of an operation about which you want detailed information. Alternatively, you can use the -verbose option for more detailed information about the hostdata object itself. Privileges Required No special privileges are needed to use the hostdata help command. Examples
dcecp> hostdata help
catalog Returns the list of hostdata object names.
create Creates a new hostdata configuration object.
delete Deletes a hostdata object and its associated data.
modify Modifies the data of a hostdata object.
show Returns the attributes of a hostdata object.
help Prints a summary of command-line options.
operations Returns a list of the valid operations for this command.
dcecp>
hostdata modify
This operation is used to change attributes of a hostdata entry, including the hostdata itself. The syntax is as follows: hostdata modify hostdata_name_list {-change attribute_list | -attribute value} [-binary] [-local] Options
-attribute value
As an alternative to using options with an attribute list, you can change individual attribute options by prepending a hyphen (-) to any attributes listed in the ATTRIBUTES section of this reference page. In the current version of DCE, only the data attribute can be modified.
-change attribute_list
Allows you to modify attributes by using an attribute list rather than using individual attribute options. The format of an attribute list is as follows:
{{attribute value}...{attribute value}}
In the current version of DCE, only the data attribute can be modified.
-binarySpecifies that the value of the data attribute is in binary form.
-localSpecifies that the command should operate on the local dced hostdata object while the dced object is in a partial-service state.
The argument is a list of names of hostdata entries to be modified. If more than one is specified all modifications specified are done to each hostdata entry listed. In the current DCE Version, only the data attribute is modifiable, and it can only be completely replaced. This operation returns an empty string on success. Privileges Required You must have w (write) permission to the hostdata container on the host. Examples
dcecp> hostdata mod file1 -data {new first line}
dcecp>
dcecp> hostdata show file1
{uuid cda3a184-eb85-11cd-91b1-080009251352}
{annotation {}}
{storage /tmp/file1}
{hostdata/data {new first line}}
dcecp>
dcecp> cat /tmp/file1
new first line
dcecp>
hostdata operations
Returns a list of the operations supported by the hostdata object. The syntax is as follows: hostdata operations The list of available operations is in alphabetical order except for help and operations, which are listed last. Privileges Required No special privileges are needed to use the hostdata operations command. Examples
dcecp> hostdata operations
catalog create delete modify show help operations
dcecp>
hostdata show
Returns an attribute list of the hostdata entries specified in the argument. The syntax is as follows: hostdata show hostdata_name_list [-ifname residual_object_name | [-entry] [-binary]] [-local] Options
-ifnameSpecifies the dced object for which to return the value.
-entryOnly the configuration information that dced keeps is returned, not the actual hostdata.
-binarySpecifies to return the value of the data attribute in binary form.
-localSpecifies that the command should operate on the local dced hostdata object while the dced object is in a partial-service state.
The hostdata_name_list argument is a list of names of hostdata entries. If called with the -entry option, then 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 of entries, 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-6eca-1d6a-bf90-0000c09ce054}
{annotation {Name of cell}}
{storage cell_name}
{hostdata/data /.../my_cell}
dcecp>
RELATED INFORMATION
Commands:
dcecp(1m), dcecp_server(1m), dced(1m).
Hewlett-Packard Company — OSF DCE 1.1/HP DCE 1.5