NAME

hostdata  — A dcecp object that manages a DCE host’s cell affiliation information

SYNOPSIS

hostdata catalog  [host_name_list]  [simplename ]  [local ]  [unauth ]

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 ]  [unauth ]

Arguments

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. 

hostdata_name_list
A list of one or more names 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.   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 string
A PCS string that identifies the name of the data repository.  In the current release of dced , it is a filename.  It is required and cannot 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. 

Errors

A representative list of errors that might be returned is not shown here.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

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 ]  [unauth ]

Options

simplename
Returns 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. 

unauthSpecifies 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. 

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 specifies objects on a foreign host.  By default, fully qualified names are returned.  Use the simplename  option to return objects names without the prepended cell name 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 Attributes. 

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 made to each hostdata  entry listed.  In the current DCE Version, only the data attribute can be modified and only by completely replacing it.  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 ] [unauth ]

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. 

unauthSpecifies 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. 

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 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(8dce), dced(8dce), hostvar(8dce).