1XMONISDN(1) X Tools XMONISDN(1)
2
6 xmonisdn - monitor for ISDN network
7
9 xmonisdn [ -toolkitoption ... ] [ -option ... ]
10
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 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
33 xmonisdn accepts all of the standard X Toolkit command line options
34 along with the additional options listed below:
35 -help This option indicates that a brief summary of the allowed
37 options should be printed on the standard error.
38 -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 -file filename
46 This option specifies the name of the file which should be mon‐
47 itored. By default, it watches /dev/isdninfo.
48 -volume percentage
50 This option specifies how loud the bell should be rung when
51 there is an important status change.
52 -shape This option indicates that the xmonisdn window should be shaped
54 if masks for the images are given.
55 The following standard X Toolkit command line arguments are commonly
57 used with xmonisdn:
58 -display display
60 This option specifies the X server to contact.
61 -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 -bg color
68 This option specifies the color to use for the background of
69 the window.
70 -bd color
72 This option specifies the color to use for the border of the
73 window.
74 -bw number
76 This option specifies the width in pixels of the border sur‐
77 rounding the window.
78 -fg color
80 This option specifies the color to use for the foreground of
81 the window.
82 -rv This option indicates that reverse video should be simulated by
84 swapping the foreground and background colors.
85 -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
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 file (class File)
97 Specifies the name of the file to monitor. The default is to
98 watch /dev/isdninfo.
99 width (class Width)
101 Specifies the width of the icon.
102 height (class Height)
104 Specifies the height of the icon.
105 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 volume (class Volume)
111 Specifies how loud the bell should be rung. The default is 33
112 percent.
113 foreground (class Foreground)
115 Specifies the color for the foreground.
116 reverseVideo (class ReverseVideo)
118 Specifies that the foreground and background should be
119 reversed.
120 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 inactivePixmap (class Pixmap)
127 Specifies a bitmap to be shown when the ISDN subsystem is inac‐
128 tive. The default is netinactive.
129 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 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 activeoutPixmap (class Pixmap)
140 Specifies a bitmap to be shown when there is a outgoing network
141 connection. The default is netactiveout.
142 startPixmap (class Pixmap)
144 Specifies a bitmap to be shown when the ISDN network is started
145 up. The default is netstart.
146 stopPixmap (class Pixmap)
148 Specifies a bitmap to be shown when the ISDN network is
149 stopped. The default is netstop.
150 shapeWindow (class ShapeWindow)
152 Specifies whether or not the xmonisdn window should be shaped
153 to the given PixmapMasks. The default is false.
154 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 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 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 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 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 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
182 The Netstat widget provides the following actions for use in event
183 translations:
184 check() This action causes the widget to check the isdninfo file and
186 display the appropriate icon.
187 netdown()
189 This action causes the widget to execute /sbin/ifdown stop.
190 netup() This action causes the widget to execute /sbin/ifup start.
192 The default translation is
194 <ButtonPress>Button2: netup()
196 <ButtonPress>Button3: netdown()
197
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 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
222 DISPLAY to get the default host and display number.
223 XENVIRONMENT
225 to get the name of a resource file that overrides the global
226 resources stored in the RESOURCE_MANAGER property.
227
229 Bernhard Nebel
230
232 isdnctrl(8)
233isdn4k-utils-3.27 2002/01/31 XMONISDN(1)