NAME

hostvar  — A dcecp task object that manages the security binary compatibility attributes

SYNOPSIS

hostvar help  [operation | verbose  ]

hostvar operations

hostvar set  {secbinarycompat   {on | off } | krbccachevno version_number | krbktvno version_number }

hostvar show  {all  | cellname  | hostname  | krbccachevno  | krbktvno  | secbinarycompat  }

Arguments

operationThe name of the hostvar  operation for which to display help information. 

Description

The hostvar  object allows you to easily set the security binary compatibility attribute and the Kerberos V5 compatibility attribute for the current host.  It also lets you display the local host’s cellname, hostname, security binary compatibility attribute, and Kerberos V5 compatibility attributes that are stored by the dced  in the hostdata/dce_cf.db object. 

The cell’s security server uses these compatibility attributes to determine the mode and state in which the local machine is operating. 

Attributes

cellnameThe name of the local hosts cell. 

hostnameThe name of the local host. 

krbccachevno
The version number format of the Kerberos V5 credential cache files created by DCE applications.  The version chosen should allow optimal compatibility with any Kerberos V5 applications running on the host. Valid values are the integers 1 through 3, inclusive.  See the OSF DCE Administration Guide for more information about Kerberos 5 attributes. 

krbktvnoThe version number format of the Kerberos V5 keytab files created by DCE applications.  The version number format chosen should allow optimal compatibility with any Kerberos V5 applications running on the host.  Valid values are the integers 1 and 2.  See the OSF DCE Administration Guide for more information about Kerberos 5 attributes. 

secbinarycompat
The security binary compatibility attribute that enables (on) and disables (off) binary compatibility for statically linked versions of DCE. 

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

hostvar help

Returns help information about the hostvar  task object and its operations.  The syntax is as follows:

hostvar help [operation | verbose ]

Option

verboseDisplays information about the hostvar  task object. 

Used without an argument or option, the hostvar help  command returns brief information about each hostvar  operation.  The optional operation argument is the name of an operation about which you want detailed information.  Alternatively, you can use the verbose  option to display detailed information about the hostvar task object itself. 

Privileges Required

No special privileges are needed to use the hostvar help  command. 

Examples

dcecp> hostvar help
set                 Sets the value of the specified host variable.
show                Returns the value of the specified host variable.
help                Prints a summary of command-line options.
operations          Returns a list of the valid operations for this command.
dcecp> 

hostvar operations

Returns a list of the operations supported by the hostvar  task object.  The syntax is as follows:

hostvar 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 hostvar operations command. 

Examples

dcecp> hostvar operations
set show help operations
dcecp> 

hostvar set

Sets the security binary compatibility and krb5 compatibility value attributes for the current host.  The syntax is as follows:

 hostvar set {secbinarycompat  {on | off} |
[krbccachevno  version_number] [krbktvno  version_number]}

Option

secbinarycompat
Sets the security binary compatibility attribute on or off.  This cannot be used with the krbccachevno  and krbktvno  options. 

krbccachevno
Sets the Kerberos V5 credential cache file version number format.

krbktvnoSets the Kerberos V5 keytab file version number format. 

Under normal circumstances, secbinarycompat is set to on when DCE is configured, which allows binary compatibility between Version 1.2 and Versions 1.0.3 and 1.1. Binary compatibility allows applications linked with an archived libdce to share login contexts and credentials without loss of data. 

You can disable binary compatibility on a per-host basis to achieve minor performance gains and slightly smaller credentials files by setting secbinarycompat to off.  If you enable binary compatibility after it has been disabled, you must start and stop all DCE daemons.  This operation returns an empty string on success. 

The krbccachevno  and krbktvno  attributes are set to 1 when DCE is configured to allow compatibility with DCE 1.0.3 based applications and older Kerberos V5 applications. Depending on certain compatibility requirements, you may choose to change the values of the attributes.  See the OSF DCE Administration Guide for more information about Kerberos 5 attributes. 

Privileges Required

No special privileges are required to use the hostvar set  command. 

Examples

dcecp> hostvar set -secbinarycompat on
dcecp>  

hostvar show

Returns the values of the host attributes on the local host.  The syntax is as follows:

hostvar show  {all  |  [cellname ] [hostname ] [krbccachevno ] [krbktvno ]
 [secbinarycompat ]}

Options

allReturns the values of all attributes. 

cellnameReturns the value of the cellname attribute. 

hostnameReturns the value of the hostname attribute. 

krbccachevno
Returns the value of the krbccachevno attribute. 

krbktvnoReturns the value of the krbktvno attribute. 

secbinarycompat
Returns the value of the secbinarycompat attribute. 

The show  operation makes it easy to view the attributes stored in the dced hostdata/dce_cf.db object.  All the values returned by this command are from that object.  Use the all  option to display all attributes; use individual options to display individual attributes. 

Privileges Required

No special privileges are required. 

Examples

dcecp> hostvar show -all
{cellname /.../gumby1}
{hostname hosts/blech}
{krbccachevno 1}
{krbktvno 1}
{secbinarycompat on}
dcecp> 

Related Information

Commands: dcecp(8dce), dced(8dce), hostdata(8dce)