1XMONISDN(1)                         X Tools                        XMONISDN(1)
2
3
4

NAME

6       xmonisdn - monitor for ISDN network
7

SYNOPSIS

9       xmonisdn [ -toolkitoption ... ] [ -option ... ]
10

DESCRIPTION

12       The xmonisdn program displays the status of the ISDN network connection
13       and allows the starting and stopping of the ISDN subsystem. If the ISDN
14       subsystem  is not active, a window showing a terminal in the foreground
15       and a dashed terminal in the backgorund is displayed. If the ISDN  sys‐
16       tem is active, but there is no network connection established, two ter‐
17       minals with dashed arrows between them is  displayed.  If  there  is  a
18       incoming  connection or there is dialing in progress, the arrows become
19       more solid. An outgoing network connection is signaled by solid  arrows
20       between the terminals and the window is displayed in reverse video.  If
21       the ISDN subsystem dials out or hangs up, the program beeps  to  signal
22       the state change (this can be changed using the volume option).
23
24       Pressing  button  2  on  the window executes the command /sbin/ifup and
25       pressing button 3 executes /sbin/ifdown
26       /sbin/ifup and /sbin/ifdown should start and stop the  ISDN  subsystem;
27       if  the  route command is used, xmonisdn must be run as setuid root for
28       this to work.  Alternatively, the scripts can manipulate  the  isdnctrl
29       dialmode setting, in which case only permission to access /dev/isdnctrl
30       is needed.
31

OPTIONS

33       xmonisdn accepts all of the standard X  Toolkit  command  line  options
34       along with the additional options listed below:
35
36       -help   This  option  indicates  that  a  brief  summary of the allowed
37               options should be printed on the standard error.
38
39       -update tenth of a second
40               This option specifies the frequency in  1/10  of  a  second  at
41               which  xmonisdn  should  update  its display.  If the window is
42               obscured and then exposed, it will be updated immediately.  The
43               default is 0.5 seconds (i.e. -update 5).
44
45       -file filename
46               This option specifies the name of the file which should be mon‐
47               itored.  By default, it watches /dev/isdninfo.
48
49       -volume percentage
50               This option specifies how loud the bell  should  be  rung  when
51               there is an important status change.
52
53       -shape  This option indicates that the xmonisdn window should be shaped
54               if masks for the  images are given.
55
56       The following standard X Toolkit command line  arguments  are  commonly
57       used with xmonisdn:
58
59       -display display
60               This option specifies the X server to contact.
61
62       -geometry geometry
63               This  option  specifies  the preferred size and position of the
64               xmonisdn window.  The icon is 48 pixels wide and 48 pixels high
65               and will be centered in the window.
66
67       -bg color
68               This  option  specifies  the color to use for the background of
69               the window.
70
71       -bd color
72               This option specifies the color to use for the  border  of  the
73               window.
74
75       -bw number
76               This  option  specifies  the width in pixels of the border sur‐
77               rounding the window.
78
79       -fg color
80               This option specifies the color to use for  the  foreground  of
81               the window.
82
83       -rv     This option indicates that reverse video should be simulated by
84               swapping the foreground and background colors.
85
86       -xrm resourcestring
87               This option specifies a resource string to be  used.   This  is
88               especially  useful for setting resources that do not have sepa‐
89               rate command line options.
90

X DEFAULTS

92       The application class name is xmonisdn.  This program uses the  Netstat
93       widget.   It  understands all of the core resource names and classes as
94       well as:
95
96       file (class File)
97               Specifies the name of the file to monitor.  The default  is  to
98               watch /dev/isdninfo.
99
100       width (class Width)
101               Specifies the width of the icon.
102
103       height (class Height)
104               Specifies the height of the icon.
105
106       update (class Interval)
107               Specifies  the  frequency in 1/10 of a second at which the isd‐
108               ninfo file should be checked.  The default is 5.
109
110       volume (class Volume)
111               Specifies how loud the bell should be rung.  The default is  33
112               percent.
113
114       foreground (class Foreground)
115               Specifies the color for the foreground.
116
117       reverseVideo (class ReverseVideo)
118               Specifies   that   the  foreground  and  background  should  be
119               reversed.
120
121       flip (class Flip)
122               Specifies whether or not the image that is shown when there  is
123               an outgoing network connection should be inverted.  The default
124               is ``true.''
125
126       inactivePixmap (class Pixmap)
127               Specifies a bitmap to be shown when the ISDN subsystem is inac‐
128               tive.  The default is netinactive.
129
130       waitingPixmap (class Pixmap)
131               Specifies  a  bitmap  to  be  shown  when the ISDN subsystem is
132               active, but there is no connection. The default is netwaiting.
133
134       activePixmap (class Pixmap)
135               Specifies a bitmap to be shown when there is a incoming network
136               connection  (or  dialing is in progress). The default is netac‐
137               tive.
138
139       activeoutPixmap (class Pixmap)
140               Specifies a bitmap to be shown when there is a outgoing network
141               connection.  The default is netactiveout.
142
143       startPixmap (class Pixmap)
144               Specifies a bitmap to be shown when the ISDN network is started
145               up.  The default is netstart.
146
147       stopPixmap (class Pixmap)
148               Specifies a bitmap  to  be  shown  when  the  ISDN  network  is
149               stopped.  The default is netstop.
150
151       shapeWindow (class ShapeWindow)
152               Specifies  whether  or not the xmonisdn window should be shaped
153               to the given PixmapMasks.  The default is false.
154
155       inactivePixmapMask (class PixmapMask)
156               Specifies a mask for the bitmap to be shown when the ISDN  sub‐
157               system is inactive.  The default is none.
158
159       waitingPixmapMask (class PixmapMask)
160               Specifies  a mask for the bitmap to be shown when the ISDN sub‐
161               system is active, but there is no connection.  The  default  is
162               none.
163
164       activePixmapMask (class PixmapMask)
165               Specifies  a mask for the bitmap to be shown when when there is
166               a incoming network connection (or dialing is in progress).  The
167               default is none.
168
169       activeoutPixmapMask (class PixmapMask)
170               Specifies  a  mask  for the bitmap to be shown when  there is a
171               outgoing network connection.  The default is none.
172
173       startPixmapMask (class PixmapMask)
174               Specifies a mask for the bitmap to be shown when  the ISDN net‐
175               work is started up.  The default is none.
176
177       stopPixmapMask (class PixmapMask)
178               Specifies a mask for the bitmap to be shown when  the ISDN net‐
179               work is stopped.  The default is none.
180

ACTIONS

182       The Netstat widget provides the following  actions  for  use  in  event
183       translations:
184
185       check() This  action  causes  the widget to check the isdninfo file and
186               display the appropriate icon.
187
188       netdown()
189               This action causes the widget to execute /sbin/ifdown stop.
190
191       netup() This action causes the widget to execute /sbin/ifup start.
192
193       The default translation is
194
195               <ButtonPress>Button2:  netup()
196            <ButtonPress>Button3:  netdown()
197
198
199

SECURITY ISSUES

201       There are a number of reasons why you should  not  run  xmonisdn  as  a
202       `setuid  root' program.  Most importantly, any setuid root program is a
203       potential security hole.  The scripts that are executed by xmonisdn may
204       be  compromised,  or  contain non-absolute paths to the commands called
205       (so that by changing the PATH variable the wrong binary is  executed!);
206       or the script may in turn call other things that are not secure.
207       If  you  are sure that your scripts are secure and you insist on making
208       xmonisdn setuid root, you can give the -r option as first option.  This
209       will turn off xmonisdn's setuid detection. However, you are on your own
210       if you do this!
211
212       A better alternative is to put the isdn devices in  group  dialout  (if
213       not  so  already),  and add yourself to the dialout group. This way you
214       have permission to manipulate the ISDN devices, e.g.  to  use  isdnctrl
215       to change the dialmode setting to off (to disable dialing) or auto (for
216       autodial). The whole ISDN system may also be turned on and off, see the
217       isdnctrl  manpage for more info.  This is a more secure way of control‐
218       ling the dialing than e.g. by manipulating routes.
219
220

ENVIRONMENT

222       DISPLAY to get the default host and display number.
223
224       XENVIRONMENT
225               to get the name of a resource file that  overrides  the  global
226               resources stored in the RESOURCE_MANAGER property.
227

AUTHOR

229       Bernhard Nebel
230

SEE ALSO

232       isdnctrl(8)
233
234
235
236isdn4k-utils-3.13                 2002/01/31                       XMONISDN(1)
Impressum