wmclockmon: handle fgets NULL returns and zero-length lines
[dockapps.git] / wmisdn / SCRIPTS
blob29989fafaac02709e7ada8173741abdddb542113
1 This file concerns the usage of scripts with wmisdn.
2 ----------------------------------------------------
5 NOTE: The wmisdn scripting is ONLY for ADVANCED unix users. I can't give any
6       support for user-made scripts.
9 Ok, if you're still here, then you know what you're doing, so I won't go into
10 details explaining well known things about Linux.
12 As of version 1.8, wmisdn can use scripts to control the connection instead of
13 direct ioctl calls. If you want to use scripts, then put the "-usescripts"
14 option on the command line. The three files used by wmisdn are
16 wmisdn-up
17 wmisdn-down
18 wmisdn-scriptmodes
20 They must be located in /etc/isdn/, or in a directory specified by the
21 "-path" command line option.
23 The first two are called when the green resp. yellow lamp is pressed. These
24 two scripts recieve two parameters. The first one is the name of the
25 ippp-device and the second is the script mode.
27 The script mode is an integer, which corresponds to a line in the file
28 wmisdn-scriptmodes. Every line in this file defines one script mode - the first
29 line is mode 0, the second - mode 1, and so on. The contents of each line is
30 used as a user-friendly name for the script mode and is displayed on the info
31 window. The script modes are changed by pressing the green control lamp with
32 the middle mouse button.
34 A sample wmisdn-scriptmodes might look like
36 go online
37 check mail
38 update web-page
40 where the wmisdn-up script uses the second command line argument to differ
41 between these modes (0,1 or 2 resp.). The -up/-down scripts should contain
42 the line
43 /usr/sbin/isdnctrl dial $1
45 /usr/sbin/isdnctrl hangup $1
46 respectively.
48 I might consider putting some scripts on my web-page in the near future. I'd
49 also wellcome any user-made working scripts.
51 Good luck and have fun!
52 Tasho