Query: dcecp_hostdata
OS: hpux
Section: 1m
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
hostdata(1m) hostdata(1m)NAMEhostdata - A dcecp object that manages a DCE host's cell affiliation informationSYNOPSIShostdata 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_hostdata_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 residual_hostdata_name | -local] [-unauth]ARGUMENTSA list of one or more DCE host names specifying hosts for which to catalog 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 supply 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.DESCRIPTIONThe 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 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 con- sisting 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.ATTRIBUTESAn 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. 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 identi- fies the name of the data repository. In the current release of dced, it is a filename. It is required and cannot be modified after cre- ation. An attribute that represents the actual data. Its syntax is a list of strings. The data can be viewed and modified in two differ- ent 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.OPERATIONShostdata 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 con- nected. 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 hostdata container names. Privileges Required You must have r (read) permission to the hostdata container on the specified 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/host- data/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/con- fig/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 section 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 information 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: hostdata delete hostdata_name_list [-entry] [-ifname residual_host- data_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 binding 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 configura- tion 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} [-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 modify, 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 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 [-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 par- tial-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 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 iden- tify the specific hostdata entry to show, but only when the argument is a string binding representing a host, not the fully qualified host- data name. Privileges Required You must have r (read) permission to the hostdata container on the specified 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 INFORMATIONCommands: dcecp(1m), dced(1m). hostdata(1m)