xmonisdn − monitor for ISDN network
xmonisdn [ −toolkitoption ... ] [ −option ... ]
The xmonisdn program displays the status of the ISDN network connection and allows the starting and stopping of the ISDN subsystem. If the ISDN subsystem is not active, a window showing a terminal in the foreground and a dashed terminal in the backgorund is displayed. If the ISDN system is active, but there is no network connection established, two terminals with dashed arrows between them is displayed. If there is a incoming connection or there is dialing in progress, the arrows become more solid. An outgoing network connection is signaled by solid arrows between the terminals and the window is displayed in reverse video. If the ISDN subsystem dials out or hangs up, the program beeps to signal the state change (this can be changed using the volume option).
Pressing button
2 on the window executes the command /sbin/netup and
pressing button 3 executes /sbin/netdown
/sbin/netup and /sbin/netdown should start and
stop the ISDN subsystem; if the route command is
used, xmonisdn must be run as setuid root for this to work.
Alternatively, the scripts can manipulate the isdnctrl
dialmode setting, in which case only permission to
access /dev/isdnctrl is needed.
xmonisdn accepts all of the standard X Toolkit command line options along with the additional options listed below:
−help |
This option indicates that a brief summary of the allowed options should be printed on the standard error. |
−update tenth of a second
This option specifies the frequency in 1/10 of a second at which xmonisdn should update its display. If the window is obscured and then exposed, it will be updated immediately. The default is 0.5 seconds (i.e. -update 5).
−file filename
This option specifies the name of the file which should be monitored. By default, it watches /dev/isdninfo.
−volume percentage
This option specifies how loud the bell should be rung when there is an important status change.
−shape |
This option indicates that the xmonisdn window should be shaped if masks for the images are given. |
The following
standard X Toolkit command line arguments are commonly used
with xmonisdn:
−display display
This option specifies the X server to contact.
−geometry geometry
This option specifies the preferred size and position of the xmonisdn window. The icon is 48 pixels wide and 48 pixels high and will be centered in the window.
−bg color
This option specifies the color to use for the background of the window.
−bd color
This option specifies the color to use for the border of the window.
−bw number
This option specifies the width in pixels of the border surrounding the window.
−fg color
This option specifies the color to use for the foreground of the window.
−rv |
This option indicates that reverse video should be simulated by swapping the foreground and background colors. |
−xrm resourcestring
This option specifies a resource string to be used. This is especially useful for setting resources that do not have separate command line options.
The application
class name is xmonisdn. This program uses the Netstat
widget. It understands all of the core resource names and
classes as well as:
file (class File)
Specifies the name of the file to monitor. The default is to watch /dev/isdninfo.
width (class Width)
Specifies the width of the icon.
height (class Height)
Specifies the height of the icon.
update (class Interval)
Specifies the frequency in 1/10 of a second at which the isdninfo file should be checked. The default is 5.
volume (class Volume)
Specifies how loud the bell should be rung. The default is 33 percent.
foreground (class Foreground)
Specifies the color for the foreground.
reverseVideo (class ReverseVideo)
Specifies that the foreground and background should be reversed.
flip (class Flip)
Specifies whether or not the image that is shown when there is an outgoing network connection should be inverted. The default is ‘‘true.’’
inactivePixmap (class Pixmap)
Specifies a bitmap to be shown when the ISDN subsystem is inactive. The default is netinactive.
waitingPixmap (class Pixmap)
Specifies a bitmap to be shown when the ISDN subsystem is active, but there is no connection. The default is netwaiting.
activePixmap (class Pixmap)
Specifies a bitmap to be shown when there is a incoming network connection (or dialing is in progress). The default is netactive.
activeoutPixmap (class Pixmap)
Specifies a bitmap to be shown when there is a outgoing network connection. The default is netactiveout.
startPixmap (class Pixmap)
Specifies a bitmap to be shown when the ISDN network is started up. The default is netstart.
stopPixmap (class Pixmap)
Specifies a bitmap to be shown when the ISDN network is stopped. The default is netstop.
shapeWindow (class ShapeWindow)
Specifies whether or not the xmonisdn window should be shaped to the given PixmapMasks. The default is false.
inactivePixmapMask (class PixmapMask)
Specifies a mask for the bitmap to be shown when the ISDN subsystem is inactive. The default is none.
waitingPixmapMask (class PixmapMask)
Specifies a mask for the bitmap to be shown when the ISDN subsystem is active, but there is no connection. The default is none.
activePixmapMask (class PixmapMask)
Specifies a mask for the bitmap to be shown when when there is a incoming network connection (or dialing is in progress). The default is none.
activeoutPixmapMask (class PixmapMask)
Specifies a mask for the bitmap to be shown when there is a outgoing network connection. The default is none.
startPixmapMask (class PixmapMask)
Specifies a mask for the bitmap to be shown when the ISDN network is started up. The default is none.
stopPixmapMask (class PixmapMask)
Specifies a mask for the bitmap to be shown when the ISDN network is stopped. The default is none.
The Netstat widget provides the following actions for use in event translations:
check() |
This action causes the widget to check the isdninfo file and display the appropriate icon. |
netdown()
This action causes the widget to execute /sbin/netdown stop.
netup() |
This action causes the widget to execute /sbin/netup start. |
The default translation is
<ButtonPress>Button2: netup()
<ButtonPress>Button3: netdown() |
There are a
number of reasons why you should not run xmonisdn as
a ‘setuid root’ program. Most importantly, any
setuid root program is a potential security hole. The
scripts that are executed by xmonisdn may be
compromised, or contain non-absolute paths to the commands
called (so that by changing the PATH variable the wrong
binary is executed!); or the script may in turn call other
things that are not secure.
If you are sure that your scripts are secure and you insist
on making xmonisdn setuid root, you can give the
-r option as first option. This will turn off
xmonisdn’s setuid detection. However, you are on your
own if you do this!
A better alternative is to put the isdn devices in group dialout (if not so already), and add yourself to the dialout group. This way you have permission to manipulate the ISDN devices, e.g. to use isdnctrl to change the dialmode setting to off (to disable dialing) or auto (for autodial). The whole ISDN system may also be turned on and off, see the isdnctrl manpage for more info. This is a more secure way of controlling the dialing than e.g. by manipulating routes.
DISPLAY |
to get the default host and display number. |
XENVIRONMENT
to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.
Bernhard Nebel
isdnctrl(8)
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.