Washington Man Page

NAME

wdc - Washington Photo Server

SYNOPSYS

wdc [ -n ] [ -a ] [ -x ] [ -p tcp/ip port ] [ -l level ] [ -f facility ] [ -i interval ]

wdc -v

DESCRIPTION

wdc is the Washington Photo Server daemon. It is usually started once and left to run as it can be configured, administered and shutdown from a world wide web browser. There are no configuration files or support directories or files necessary. Once started the daemon waits for connection requests from browsers on port 8210.

OPTIONS

-v	Causes the version number to be printed on stdout, after which the programs exits.
-a	Allows the display and use of the debug and exit options by users.
-n	Runs wdc in the foreground allowing for easier debugging and control under shell scripts.
-x	Causes the daemon to log to a local file wdc-*.log (where * is the operating system, release number and system architecture) rather than the syslog utility. This can be useful if syslog is not (or can not be) configured.
-?	Causes the Usage string to be printed out, after which the program exits.
-p	Allows the port number that wdc will wait for connections on to be specified. The -p flag has the form: -p port where port should be greater than 1023 when wdc is started by a non privileged user.
-l	Specifies the logging level. This must be in the range 0 to 2 where 0 will cause only error messages to be logged, 1 will log informational messages while 2 will log copious amounts of spurious output. The -l flag has the form: -l level where level must be the integer 0, 1 or 2.
-f	Specifies the syslog logging facility. This must be in the range 0 to 7 where 0 will cause messages to be sent to the syslog(1) facility LOCAL0, 1 will log to LOCAL1, etc, etc. The default is 7 which causes messages to be logged to LOCAL7. The -f flag has the form: -f facility where facility must be an integer in the range 0 to 7. Note: This flag is ignored if the -x flag is set.
-i	Specifies the applet poll interval. This is the time between polls that the java applet displayed on the download progress page will update from the server. The default is 2 seconds. The -i flag has the form: -i interval where interval must be an integer in the range 1 to 15.

EXIT STATUS

0	the daemon was launched
255	failure to parse command line args or fork

SEE ALSO

syslogd(1M), syslog.conf(4), fork(2), tail(1), pmadm(1M)

WARNINGS

The return codes from startup are superficial. As the program forks early in its life to avoid over complicated initialisation, plenty of things can go wrong in the startup after becoming a daemon (and returning a good return code.)

To check on the startup status of the daemon, simply tail the syslog configured for wdc messages or log to a file with the -x option and then tail the file.

NOTES

To configure the syslog to log messages to file /var/log/wdclog for facility LOCAL7 add the following line to the syslog configuration file /etc/syslogd.conf

local7.debug

/var/log/wdclog

NOTE: the whitespaces are TABS !

It is wise to check to see what ports can be accessed. Sometimes the default permissions may not be correct.

$ ls -lL /dev/cua

total 0
crw-rw-rw-   1 root     sys      106,131072 Mar 21  1997 a
crw-r--r--   1 root     sys      106,131073 Jun  4 20:40 b
crw-rw-rw-   1 root     sys      106,131074 Apr 30 09:56 c
crw-rw-rw-   1 root     sys      106,131075 Apr 30 09:56 d

$ ls -lL /dev/term
total 0
crw-rw-rw-   1 root     tty      106,  0 Jun 23 09:40 a
crw-rw-rw-   1 root     tty      106,  1 Apr 22 15:10 b
crw--w----   1 root     tty      106,  2 Jun 24 19:22 c
crw--w----   1 root     tty      106,  3 Jun 24 19:09 d

    

You must have read and write access to the serial port for the washington photo server to work correctly.

You may also need to remove (or make bi-directional) any port monitors that may be configured. The following command may help:

# pmadm -l

PMTAG          PMTYPE         SVCTAG         FLGS ID       
zsmon          ttymon         ttyc           u    root     /dev/term/c b - /usr/bin/login - contty6H ldterm,ttcompat Welcome to Tortuga Technologies.  Please login:  - - n  #Dial in serial port
zsmon          ttymon         ttyd           u    root     /dev/term/d b - /usr/bin/login - contty6H ldterm,ttcompat Welcome to Tortuga Technologies.  Please login:  - - n  #Dial in serial port
    

Each entry specifies a port monitor, if the entry has a b after the port name, then it is bidirectional and should allow the washington photo server to use the port.

Copyright ©1998 Tortuga Technologies Pty Ltd. All rights reserved.

last updated 31-May-1999

Back