3. Johd – Jabber Over HTTP Daemon

The following table summarizes the available command line options in alphabetic order. For each option, it provides a reference to the place in the tutorial where the option is discussed.

-c class

Sets socket class. Allowed values for class are ‘CGI’ and ‘HTTP’. This option affects all subsequent ‘-l’ options appearing to the right of it, until another ‘-c’ option or end of command line is encountered, whichever occurs first.

See socket class.

-D

After startup, switch to the background and run as daemon. See daemon.

-d number

Sets debugging level. See section Logging and Debugging.

-E file

Read the 404 error page from file. This error page is returned as a response to HTTP GET requests. The file must contain a valid HTML document without external references in the ‘head’ section. See section HTTP GET Requests.

This option affects all HTTP sockets created by subsequent ‘-l’ options which appear to the right of it, until another ‘-E’ option or end of command line is encountered, whichever occurs first.

-F facility

Sets syslog facility. Allowed values for facility are: ‘user’, ‘daemon’, ‘auth’, ‘authpriv’, ‘mail’, ‘cron’, ‘local0’ through ‘local7’. All names are case-insensitive.

See section Logging and Debugging.

-h

Shows a terse help summary.

-i

Show source line information with debug messages. See section Logging and Debugging.

-L string

Sets log tag. See section Logging and Debugging.

-l url

Listen on the given url. Several ‘-l’ options can appear in the command line.

See listen option.

-P

Prefix diagnostic messages with their severity level. See section Logging and Debugging.

-p file

Write PID to file. See daemon.

-R url

Redirect HTTP GET requests to url. The argument must begin with ‘http://’. See section HTTP GET Requests.

This option affects all HTTP sockets created by subsequent ‘-l’ options which appear to the right of it, until another ‘-R’ option or end of command line is encountered, whichever occurs first.

-S name

Sets service name for TCP wrappers. This option affects all subsequent ‘-l’ options appearing to the right of it, until another ‘-S’ option or end of command line is encountered, whichever occurs first.

See TCP wrappers.

-s url

Sets URL of the default jabber server. It is used if the request does not specify the server explicitly.

-t type:timeout

Sets session idle timeout. Type is the type of the socket: ‘C’ for client sockets (either ‘CGI’ or ‘HTTP’) and ‘J’ for Jabber socket. Timeout is the timeout value, either in seconds or in ‘XhYmZs’ form.

Defaults are: ‘-t C:5m -t J:1m’.

-u user

Run as user, after completing privileged operations, such as creating sockets that listen on ports below 1024. See daemon.

-V

Prints the program version.