Table of Contents

Name

linxstat - display specific information about LINX

Synopsis

linxstat [-q] [-a] [-h] [-s]

Description

linxstat is a utility to display the status of the LINX communication system, including information about all local and known remote LINX endpoints and LINX links to remote nodes. The names, types, status and local identifiers are displayed as well as queues, attaches and hunts. The information is fetched from the LINX kernel module. The following columns can be output, in addition to a leading summary (compare the example):

PID is the id of the process owning the LINX endpoint or LINX link. As each remote endpoint are represented by a local LINX endpoint with a local identifier (spid), they are all owned by one common local process.

spid is the local LINX binary identifier for the LINX endpoint or LINX link.

name is the huntname of the LINX endpoint or LINX link. If a name is too long for the column, a "+" sign is displayed and the tailing part of the name.

type is the type of entry, i.e. local for a local LINX endpoint, link for a LINX link to another node, remote for a local representation of a remote LINX endpoint, zombie for a LINX endpoint which has been closed, illegal if an endpoint structure is illegal. unknown if linxstat cannot reach the LINX endpoint.

state is the state of the endpoint or link. The main states are running not waiting for anything, recv while waiting to receive signal buffers, poll while waiting for events with the poll(2) or select(2) system call, unknown if linxstat cannot get the state.

queued is the receive queue. This is the number of signal buffers delivered to the LINX endpoint, but not yet received.

attached(from/to) are the pending attach information. Both the number of attaches to each LINX endpoint from other endpoints and the number of attaches from each endpoint to other endpoints are displayed.

hunted are pending hunts owned by each LINX endpoint. It also includes pending hunts, sent by others but with this endpoint as sender.

Options

-q
Display more verbose receive queue information.
-a
Display more verbose pending attach information.
-h
Display more verbose pending hunt information.
-s
Display less information (simple). Only endpoint-specific information are displayed, no summary, no title and no counter columns.

Files

None.

Diagnostics

linxstat writes all information to standard output.

Known Bugs

None.

Example

This is a displayed list from linxstat.


[local:2 remote:2 link:1
[pending attach:1
[pending hunt:0
[queued signals:0
PID spid        name            type    state  queued attached hunted
                                                      (from/to)
3770 0x0001000a +x_receive_from remote  running  0      0/0     0
3770 0x00010002 linx10          link    running  0      1/0     0
3770 0x00010005 +apitest_client remote  running  0      0/0     0
3799 0x00010004 apitest_server  local   recv     0      0/1     0
3802 0x0001000b ./linxstat      local   running  0      0/0     0

With -a, more information is displayed after each line with pending attaches. Extracts from a table, created by linxstat -a:


PID spid        name            type    state  queued attached hunted
                                                      (from/to)
 246 0x00010004 pq3_2           link    running  0      1/0     0
   Attach info (from):
    [attref:0x00010000 to:0x0001000a   signo:0  size:0]
 256 0x0001000a apitest_server  local   recv     0      0/1     0
  Attach info (to):
    [attref:0x00010000 from:0x0001000a signo:0  size:0]
 260 0x00010012 /tmp/linxstat   local   running  0      0/0     0

See Also

linx(7) , linx_attach(3) , linx_hunt(3) , linx_open(3) , linxdisc(8) , linxdisc.conf(5) , linxcfg(1)

Author

Enea LINX team

Copyright

Copyright (c) 2006-2007, Enea Software AB All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of Enea Software AB nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


Table of Contents