log(1m)log(1m)NAMElog - A dcecp object that manages serviceability routing and debug
routing
SYNOPSISlog help [operation | -verbose]
log list {RPC_server_namespace_entry | string_binding_to_server} [-comp
component_name_list]
log modify {RPC_server_namespace_entry | string_binding_to_server}
-change {routing_specifications | debug_routing_specifications}
log operations
log show {RPC_server_namespace_entry | string_binding_to_server}
[-debug]
ARGUMENTS
Specifies the namespace entry of the target server. For example,
/.:/hosts/host_name/dts-entity is the name of the DTS server. The name
of the log operation for which to display help information. A remote
procedure call (RPC) string binding that describes the target server's
network location. The value has the form of an RPC string binding,
without an object Universal Unique Identifier (UUID). The binding
information contains an RPC protocol, a network address, and an end‐
point within [] (brackets), in one of the two following forms: rpc-
prot-seq:network-addr[endpoint]
object_uuid@rpc-prot-seq:network-addr[endpoint]
DESCRIPTION
The log object represents the current state of message routing for a
given server. It supports routing for both serviceability and debug
messages. Debug routing may be removed from production environment
servers while still being used by application servers.
The log command works on both local and remote servers. You can iden‐
tify the target server by supplying either the server's entry in the
namespace or a fully bound string binding. You can specify multiple
target servers as a space-separated list. When specifying multiple
servers, you can mix the namespace entry and string binding formats in
the same list.
OPERATIONSlog help
Returns help information about the log object and its operations. The
syntax is as follows: log help [operation | -verbose]
Options
Displays detailed information about the log object.
Used without an argument or option, the log help command returns brief
information about each log 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 infor‐
mation about the log object itself.
Privileges Required
No special privileges are needed to use the log help command.
Examples
dcecp> log help list Returns serviceability components
registered by a server. modify Changes serviceability
routing specifications of a server. show Returns ser‐
viceability routing settings for a server. help Prints
a summary of command-line options. operations Returns a list
of the valid operations for this command. dcecp>
log list
Returns a list of serviceability components registered by the target
server. The syntax is as follows: log list {RPC_server_namespace_entry
| string_binding_to_server} [-comp component_name_list]
Options
A list of one or more DCE serviceability component names for which
associated subcomponents should be returned.
If you specify more than one server, the returned lists for the second
and subsequent servers are concatenated to the returned list for the
first server.
The -comp option specifies a space-separated list of DCE serviceability
component names. For each named component, the command returns a list
of the associated subcomponents. For each subcomponent in the list,
the command displays its name, its level, and its description. The
order of the component names is arbitrary. If you specify more than
one component name, the resulting subcomponent lists are concatenated.
Privileges Required
No special privileges are needed to use the log list command.
Examples
dcecp> log list /.:/hosts/goober/cds-server {svc cds dts rpc sec}
dcecp>
dcecp> log list /.:/hosts/goober/cds-server -comp dts {general 0
"General server administration"} {events 0 "Events received and
acted upon"} {arith 0 "Math operations"} {ctlmsgs 0 "Control mes‐
sages received"} {msgs 0 "Messages received"} {states 0 "Server
state transitions"} {threads 0 "Thread interactions"} {config 0
"Server/cell configuration"} {sync 0 "Server sync interactions"}
dcecp>
log modify
Sets message routing specifications for one or more specified servers.
The syntax is as follows: log modify {RPC_server_namespace_entry |
string_binding_to_server} -change {routing_specifications | debug_rout‐
ing_specifications}
Options
Specifies the routing specifications (serviceability or debug) to
change.
The -change option specifies the routing specifications you want to
change. There is a fixed, well-known set of routing defaults. You can
change these defaults, but you cannot add new routings or remove exist‐
ing routings. Routing is always set on a per-server basis and is
recorded in the log object for each server. This operation returns an
empty string on success.
Serviceability and debug messages can be written to any of the normal
output destinations. You can specify routing for serviceability and
debug messages in any of the following ways: Through the dcecp log
object, if the server supports the remote serviceability interface By
the contents of the dce-local-path/svc/routing file By the contents of
an environment variable
For a complete discussion of the ways in which you can specify routings
for serviceability and debug messages, refer to the svcroute(5) refer‐
ence page.
Privileges Required
The privileges are determined by what the server allows for permis‐
sions.
Examples
dcecp> log modify /.:/tserver -change {{FATAL TEXTFILE /dev/console} \
> {ERROR TEXTFILE /tmp/timop_errors.5.100} {NOTICE BINFILE
/tmp/timop_log%ld }} dcecp>
log operations
Returns a list of the operations supported by the log object. The syn‐
tax is as follows: log 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 log operations command.
Examples
dcecp> log operations list modify show help operations dcecp>
log show
Returns a list describing the serviceability routing settings for a
server. The syntax is as follows: log show {RPC_server_namespace_entry
| string_binding_to_server} [-debug]
Options
Returns debug routing settings rather than serviceability routing set‐
tings.
If you specify more than one server, the returned routings for the sec‐
ond and subsequent servers are concatenated to the returned routings
for the first server. The order of the returned routing settings is
arbitrary.
By default the operation returns serviceability routing settings. Use
the -debug option to return debug routing settings. Debug routing set‐
tings are not available on servers for which debugging has been turned
off (production servers, for example).
Privileges Required
No special privileges are needed to use the log show command.
Examples
dcecp> log show /.../bigred/hosts/acme/cds-clerk {ERROR STDERR -}
{FATAL FILE /dev/console} {WARNING FILE /tmp/warnings.log} dcecp>
RELATED INFORMATION
Commands: dcecp(1m)
Files: svcroute(5).
log(1m)