1 07/20/87  display_connection_list
 2 
 3 
 4 Syntax as a command:  display_connection_list {-control_arg}
 5 
 6 
 7 Function:  This command displays entries in the connection list.
 8 Network administrators can use it to list network connections
 9 associated with a process, or to display detailed information about a
10 particular connection.
11 
12 
13 Control arguments:
14 -brief, -bf
15    prints brief information in tabular form.  (Default)
16 -channel CHN, -chn CHN
17    selects entries whose connection channel name matches the star name
18    CHN.
19 -long, -lg
20    prints detailed information about selected entries.
21 -offset LOC, -ofs LOC, -at LOC
22    prints the entry located at offset LOC in the active connection
23    list.  These offsets are displayed by display_connect_list -brief.
24 -owner GROUP_ID
25    selects entries owned by a process matching GROUP_ID.  In general,
26    the Login_Server is the owner of all network connections.  See Notes
27    below for the format of GROUP_ID.
28 
29 
30 -owner_id PROCESS_ID
31    selects entries owned by the process having the given octal
32    PROCESS_ID.
33 -user GROUP_ID
34    selects entries used by a process matching GROUP_ID.  A connection
35    is in use when it is logged into a process or dialed to a process.
36    See Notes below for the format of GROUP_ID.
37 -user_id PROCESS_ID,
38 -process_id PROCESS_ID,
39 -pid PROCESS_ID
40    selects entries used by the process having the given octal
41    PROCESS_ID.
42 
43 
44 Access required: Access to the hpriv_connection_list_ gate is required
45 to use this command.
46 
47 
48 Notes:  All entries are displayed if no selection arguments are given.
49 
50 The -user and -owner GROUP_ID operand is given in one of the following
51 formats:
52 
53           person_id.project_id.tag
54           person_id.project_id
55           person_id
56 
57 where any of the components can be omitted or given as an asterisk (*)
58 to match all values in that component position.
59 
60 
61 Examples:  The following example shows the tabular form of brief
62 output.
63 
64 ! display_connection_list
65 
66   AT   CONNECTION     NET  USAGE     USER                  PROCESS ID
67   210  dsa.MUL1.0002  DSA  endpoint  Login_Server.Daemon.z 004300021607
68    66  dsa.MUL1.0088  DSA  login     Brunelle.SysAdmin.a   005100021710
69   332  dsa.MUL1.0066  DSA  dial-in   GDixon.SysAdmin.a     005000021707
70   454  dsa.MUL1.0070  DSA  endpoint  Login_Server.Daemon.z 004300021607
71 
72 
73 The following example shows the itemized form of long output.
74 
75 ! display_connection_list -user .SysAdmin -lg
76 
77   Offset:              000066                  Usage:  1 (login)
78   Connection name:     dsa.MUL1.0088             Net:  DSA
79   Connection handle:   001527000020
80   User name:           Brunelle.SysAdmin.a       PID:  005100021710
81   Owner name:          Login_Server.Daemon.z     PID:  004300021607
82   Initializer handle:  000001000002115412724145
83   Terminate event chn: 327513360274440000000115
84   Disconnect entry:    dsa_session_admin_$terminate_force
85   Accounting entry:    dsa_session_admin_$accounting_force
86 
87   Offset:              000332                  Usage:  2 (dial-in)
88   Connection name:     dsa.MUL1.0066             Net:  DSA
89   Connection handle:   004445000015
90   User name:           GDixon.SysAdmin.a         PID:  005000021707
91   Owner name:          Login_Server.Daemon.z     PID:  004300021607
92   Initializer handle:  000001000003115412725322
93   Terminate event chn: 327516062576440000000122
94   Disconnect entry:    dsa_session_admin_$terminate_force
95   Accounting entry:    dsa_session_admin_$accounting_force
96