clock(1m)
NAME
clock - A dcecp object that manages the clock on a local or remote host
SYNOPSIS
clock compare [dts_entity] [-server dts_entity] clock help [operation | -verbose] clock operations clock set [dts_entity] {-to DTS_timestamp [-abruptly -epoch epoch_number] [-bypass] | -epoch epoch_number} clock show [dts_entity] [-dtsd | -inetd | -dced]
clock synchronize [dts_entity] [[-abruptly] [-dtsd | -inetd | -dced]
ARGUMENTS
dts_entityIdentifies the dtsd server or clerk to act on. With the -server option in the compare operation, dts_entity can identify a DTS time provider. When used without the -dced or -initd options, dts_entity can be either of the following:
•The name of a dtsd server, which can be on a remote host, in the format:
/.../cellname/hosts/hostname/dts-entity
•As string binding for the remote host on which the dtsd is running, such as:
{ncacn_ip_tcp 130.105.1.227}
Alternatively you can specify the binding in dcecp string format, such as:
ncacn_ip_tcp:130.105.1.227
When used with the -dced or -inetd options, dts_entity identifies the server by a simple host name in the form hostname.
operationThe name of the clock operation for which to display help information.
DESCRIPTION
The clock object represents the clock on a system, and the time that it tells. This object has commands to display and set the time. The time setting functionality is provided by DTS, unless you specify either the -dced or -inetd option. The optional argument to the clock command is the name of a DCE Version 1.1 dtsd running on some machine. Without an argument the _s(dts) convenience variable is checked. If this variable is not set, the command operates on the clock on the local machine. Use the -epoch option to change only the epoch number of the dtsd.
OPERATIONS
clock compare
Returns the difference between the clocks on the local machine and a time-provider in the cell. The syntax is as follows: clock compare [dts_entity] [-server dts_entity] Options
-server dts_entity
Optionally names a specific time-provider or a remote DTS server against which to compare the host clock. See ARGUMENTS for the format of the dts_entity argument.
The compare operation returns the difference between the clocks on the local machine and a time-provider in the cell. If a time-provider is not running and a server is not specified, the command will pick the last responding server returned by dts catalog. An optional argument compares a remote host’s clock against a time-provider. An optional -server option compares the clock against a specific time-provider. Privileges Required You must have r (read) permission on the pertinent DTS entities to execute the command. Examples
dcecp> clock compare
{server /.:/gumby/hosts/oddball/dts_entity}
{provider no}
{skew -0-00:00:00.020I-----}
dcecp>
clock help
Returns help information about the clock object and its operations. The syntax is as follows: clock help [operation | -verbose] Options
-verboseDisplays information about the clock object.
Used without an argument or option, the clock help command returns brief information about each clock 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 clock object itself. Privileges Required No special privileges are needed to use the clock help command. Examples
dcecp> clock help
compare Returns the difference between the local clock and a server.
set Sets the system clock to the specified time.
show Returns the current time as a DTS style timestamp.
synchronize Synchronizes the local clock with the specified server.
help Prints a summary of command-line options.
operations Returns a list of the valid operations for this command.
dcecp>
clock operations
Returns a list of the operations supported by the clock object. The syntax is as follows: clock 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 clock operations command. Examples
dcecp> clock operations
compare set show synchronize help operations
dcecp>
clock set
Sets the clock to the specified time. The syntax is as follows: clock set [dts_entity] {-to DTS_timestamp [-abruptly -epoch epoch_number] [-bypass] | -epoch epoch_number} Options
-to DTS_timestamp
This option specifies a DTS timestamp as the time to which to set the clock. You can specify the time in the ISO compliant time format, as follows:
CCYY-MM-DD-hh:mm:ss.fff
-abruptlySpecifies to set the clock abruptly rather than gradually adjust it to the computed time.
-bypassSets the system clock to the specified time without using DTS.
-epoch epoch_number
Specifies an epoch_number that matches the epochs of servers with which the local clock synchronizes.
The set operation sets the local clock to the specified time. An optional argument specifies to set the clock on a remote host. The -to option specifies a DTS timestamp as the time to which to set the clock. If you do not specify the -bypass option, DTS adjusts the clock gradually to the specified time. The -abruptly option changes to the specified time, without gradual adjustments. If you specify the -abruptly option, you must also specify the -epoch option to indicate a new epoch. You can also use the -epoch option without specifying a time to pull the specified dts_entity out of synchronization. This operation returns an empty string on success. Note that setting your system clock is a dangerous operation. If your machine is not synchronized with other machines in the cell, other DCE services, especially CDS, will not operate correctly. See the OSF DCE Administration Guide for more information about DTS. Privileges Required You must have w (write) permission on the clock object in order to execute the command. Examples
dcecp> clock set -to 1994-07-15-16:27:28.000-04:00 -abruptly -epoch 1
dcecp>
dcecp> clock set -epoch 5
dcecp>
clock show
Returns a DTS-style timestamp including the time differential factor (TDF). The syntax is as follows: clock show [dts_entity] [-dtsd | -inetd | -dced] Options
-dcedUse dced services instead of DTS to report the time.
-inetdUse inetd socket connections instead of DTS to report the time
-dtsdUse DTS services to report the time.
The show operation returns a DTS style timestamp with the TDF indicated. Use the dts_entity argument to specify a remote host on which to show the clock. Two options let you specify that the time should be returned without using DTS services:
•The -dced option specifies that dced services should be used instead of DTS services
•The -inetd option specifies that inetd socket connections should be used instead of DTS
Privileges Required You must have r (read) permission on the clock object in order to execute the command. Examples
dcecp> clock show
1994-07-15-16:28:02.229+00:00I-----
dcecp>
dcecp> clock show oddball -dced
1994-07-16-17:29:05.321+00:00I-----
dcecp>
clock synchronize
Causes dtsd to synchronize gradually with time-providers. The syntax is as follows: clock synchronize [dts_entity] [[-abruptly] [-dtsd] | -inetd | -dtsd] Options
-abruptlyCauses the clock to be set abruptly rather than gradually adjusted to the computed time.
-dcedUse dced services instead of DTS as the time source.
-inetdUse inetd socket connections instead of DTS as the time source.
-dtsdUse DTS services as the time source.
The synchronize operation causes the local dtsd to gradually synchronize the local clock with the time from DTS time-providers. The -abruptly option changes to the specified time immediately, without gradual adjustments. By default, the time is retrieved from DTS. If the -dced option is specified, the time is retrieved from dced services. If the -inetd option is specified, the time is retrieved from inetd socket connections. The optional dts_entry argument synchronizes the clock on the named remote host. This operation returns an empty string on success. Privileges Required You must have w (write) permission on the clock object in order to execute the command. Examples
dcecp> clock synchronize
dcecp>
RELATED INFORMATION
Commands:
dcecp(1m), dts(1m), dtsd(1m), dcecp_dts_intro(1m), dcecp_utc(1m).
Hewlett-Packard Company — OSF DCE 1.1/HP DCE 1.5