tcl.:ent-status

Verb: Access/TCL, Releases: AP/Unix

displays the status of an entity, device or PIB.

Syntax

:ent-status id {(option}

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

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.

See Also

Command Name Type Description
general.entity Definition
tcl.dev-att Verb: Access Attaches a port to the current port.
tcl.link-pibdev Verb: Access Links the port to the device#.
tcl.:ent-list Verb: Access List system entities
tcl.:ent-mon Verb: Access Monitor data sent to an entity
tcl.list-tandems Verb: Access List devices in tandem.
tcl.:reset-async Verb: Access Resets current or all ports.
tcl.unlink-pibdev Verb: Access Unlinks a process from a port.
tcl.dev-det Verb: Access Detaches a port from the current port.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.