tcl.:ent-status Verb: Access/TCL

tcl.:ent-status

Command tcl.:ent-status Verb: Access/TCL
Applicable release versions: AP/Unix
Category TCL (746)
Description displays the status of an entity, device or PIB, on the system.

"id" is the entity id to examine. See "entity" for a definition of the format of an entity id.

The following information is displayed for all entity types:
Entity ......... s15 Entity id ...... x'0003000F'
Name ........... 0000 Version ........ 00.00
Lock owner ..... Attached by ....
Linked to ...... P15 Forwarding to ..
Association id . 0 Association code 0
I/O Buffer size 184 Nb of writes ... 0
Nb of reads .... 0 Nb of Errors ... 0

"Entity"
Entity name.

"Entity id"
Entity id in hexadecimal.

"Name"
Optional driver code name. Currently 0.

"Version"
Optional driver version.

"Lock owner"
Entity id of the entity which has this entity locked. Entity locks are set only temporarily to perform some special functions on a device. This field should normally be null. ":reset-async" resets this lock.

"Attached by"
Entity id of the entity which has attached this entity by performing a "dev-att" command.

"Linked to"
Entity id of the output link, where normal data is sent to. If empty, the entity has been 'unlinked' by the command "unlink-pibdev". Links are created by "link-pibdev", "tandem", "mirror", "converse", ...

"Forwarding to"
Entity id of the forwarding link, where data received by an entity is forwarded to. This field is normally set by commands like "tandem", ":ent-mon".

"Association id"
Unique integer representing an association, or set of links between entities in the system. "tandem" is an example of association where several devices and processes cooperate in an association to perform a function.

"Association code"
Type of the association. This code is used by "list-tandems", for example, to identify the association.

"I/O buffer size"
Size in bytes of the internal buffers.

"Nb of writes, reads, errors"
Statistics. Currently unused.

The following information is displayed for serial entities (some fields may be implementation specific):
Controller addr. 00000000 Device addr .... 00000000
Interrupt ...... 00000000 Baud rate....... 9600
Parity ......... 0 Stop bits ...... 1
Bits/char ...... 8 Protocol ....... 0
DTR status ..... 00000000
VINTR .......... 0000001F VQUIT .......... 000000FF
CLOCAL ......... 00000000 Device ......... /dev/pts/10
Syntax :ent-status id {(option}
Options V Verbose. Without this option, only raw hexadecimal data is displayed.
Example
:ent-status p15 (v
   Display the status of the PIB 15.

:ent-status s15 (v
   Display the status of the serial device 15.
Purpose
Related general.entity
tcl.dev-att
tcl.link-pibdev
tcl.:ent-list
tcl.:ent-mon
tcl.list-tandems
tcl.:reset-async
tcl.unlink-pibdev
tcl.dev-det