hostdata(1m)hostdata(1m)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} [-ifname residual_hostdata_name | -local] [-entry]
[-binary]
hostdata delete hostdata_name_list [-entry] [-ifname residual_host‐
data_name | -local]
hostdata help [operation | -verbose]
hostdata modify hostdata_name_list {-change attribute_list | -attribute
value} [-ifname residual_hostdata_name | -local] [-binary]
hostdata operations
hostdata show hostdata_name_list [-entry] [-binary] [-ifname resid‐
ual_hostdata_name | -local] [-unauth]
ARGUMENTS
A list of one or more DCE host names specifying hosts for which to cat‐
alog hostdata objects. Host names can be in any of the following
forms: /.:/hosts/hostname
/.../cell_name/hosts/hostname
hosts/hostname
The name can also be a single string binding representing the host with
which to communicate. See hostdata_name_list for more information. A
list of one or more names of host data items. Usually they are of the
following form: /.:/hosts/hostname/config/hostdata/name
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 sup‐
ply a single string binding, you must use the -ifname option to specify
the object's residual name. The 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 host‐
data object is represented by the hostdata/data attribute of the host‐
data 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 name, not
/.:/hosts/gumby/config/hostdata/name.
ATTRIBUTES
An internal identifier for the hostdata entry. Its value is a Univer‐
sal Unique Identifier (UUID). If not specified on creation, one is
generated by dcecp. This attribute cannot be modified after creation.
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). 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. 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 host‐
data file.
See the OSF DCE Administration Guide for more information about host‐
data 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] [-unauth]
Options Returns a list of hostdata entries without prepending the cell
name and name of the hostdata container. Specifies that the command
should operate on the local dced hostdata object while the dced
process is in a partial-service state. 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.
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 object names without the prepended cell name and host‐
data container names.
Privileges Required
You must have r (read) permission to the hostdata container on the
specified host (/.:/hosts/host_name/config/hostdata/hostdata_con‐
tainer).
Examples
dcecp> hostdata catalog /.../gumby1/hosts/fire/config/host‐
data/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} [-ifname residual_hostdata_name | -local] [-entry]
[-binary]
Options 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 sec‐
tion of this reference page. Allows you to specify attributes by using
an attribute list rather than individual attribute options. The format
of an attribute list is as follows: {{attribute value}...{attribute
value}} Specifies that the value of the data attribute is in binary
form. Specifies that the command should operate on the local dced
hostdata object while the dced process is in a partial-service state.
Only the configuration information that dced keeps is created, not the
actual hostdata. Specifies the dced hostdata object to create.
The hostdata_name_list argument is a list of names of hostdata entries
to be created. The -attributes option specifies configuration informa‐
tion for dced. The contents of the hostdata file can be specified via
the data attribute. If called with the -entry option, the data
attribute is not allowed. The value of the option is applied to all
elements of the argument list. The -ifname option is used to identify
the specific hostdata entry to create, but only when the argument is a
string binding representing a host, not a fully qualified hostdata
name. 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>
dcecp> hostdata create ncacn_ip_tcp:15.22.24.145 -ifname gumby_attr \ >
-storage /tmp/gumby_file -data {{line one} {line two}} dcecp>
hostdata delete
Deletes a hostdata entry and its data. The syntax is as follows: host‐
data delete hostdata_name_list [-entry] [-ifname residual_hostdata_name
| -local]
Options Only the configuration information that dced keeps is deleted,
not the actual hostdata. Specifies that the command should operate on
the local dced hostdata object while the dced process is in a partial-
service state. Specifies the dced hostdata object to delete.
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. The -ifname option is used to identify the specific
hostdata entry to delete, but only when the argument is a string bind‐
ing representing a host, not the fully qualified hostdata name. 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>
dcecp> hostdata delete ncacn_ip_tcp:15.22.24.145 -ifname gumby_attr
dcecp>
hostdata help
Returns help information about the hostdata object and its operations.
The syntax is as follows: hostdata help [operation | -verbose]
Options Displays information about the hostdata object.
Used without an argument or option, the hostdata help command returns
brief information about each hostdata operation. The optional opera‐
tion 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 associ‐
ated 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 mod‐
ify hostdata_name_list {-change attribute_list | -attribute value}
[-ifname residual_hostdata_name | -local] [-binary]
Options As an alternative to using the -change 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.
In the current version of DCE, only the data attribute can be modified.
Allows you to modify attributes by using an attribute list rather than
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.
Specifies that the value of the data attribute is in binary form.
Specifies that the command should operate on the local dced hostdata
object while the dced process is in a partial-service state. Speci‐
fies the dced hostdata object to modify.
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. The
-ifname option is used to identify the specific hostdata entry to mod‐
ify, but only when the argument is a string binding representing a
host, not the fully qualified hostdata name. 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 modify 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>
dcecp> hostdata modify ncacn_ip_tcp:15.22.24.145 -ifname gumby_attr \ >
-data {new improved line one} 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 com‐
mand.
Examples
dcecp> hostdata operations catalog create delete modify show help oper‐
ations 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
[-entry] [-binary] [-ifname residual_hostdata_name | -local] [-unauth]
Options Specifies the dced hostdata object for which to return the
value. Only the configuration information that dced keeps is returned,
not the actual hostdata. Specifies to return the value of the data
attribute in binary form. Specifies that the command should operate on
the local dced hostdata object while the dced process is in a partial-
service state. Specifies that the command should operate as if an
unauthenticated user is running it. This option is useful for inter‐
cell 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
specified host (/.:/hosts/host_name/config/hostdata/hostdata_con‐
tainer).
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), dced(1m).
hostdata(1m)