urxvt256c-mld (1) - Linux Man Pages
urxvt256c-mld: urxvt256c-ml terminal daemon
urxvt256c-mld - urxvt256c-ml terminal daemon
SYNOPSISurxvt256c-mld [-q|--quiet] [-o|--opendisplay] [-f|--fork] [-m|--mlock] [-e|--eval perlstring]
urxvt256c-mld -q -o -f # for .xsession use
DESCRIPTIONThis manpage describes the urxvt256c-mld daemon, which is the same vt102 terminal emulator as urxvt256c-ml, but runs as a daemon that can open multiple terminal windows within the same process.
You can run it from your X startup scripts, for example, although it is not dependent on a working DISPLAY and, in fact, can open windows on multiple X displays on the same time.
Advantages of running a urxvt256c-ml daemon include faster creation time for terminal windows and a lot of saved memory.
The disadvantage is a possible impact on stability - if the main program crashes, all processes in the terminal windows are terminated. For example, as there is no way to cleanly react to abnormal connection closes, "xkill" and server resets/restarts will kill the urxvt256c-mld instance including all windows it has opened.
OPTIONSurxvt256c-mld currently understands a few options only. Bundling of options is not yet supported.
- -q, --quiet
- Normally, urxvt256c-mld outputs the message "rxvt-unicode daemon listening on <path>" after binding to its control socket. This option will suppress this message (errors and warnings will still be logged).
- -o, --opendisplay
This forces urxvt256c-mld to open a connection to the current
$DISPLAY and keep it open.
This is useful if you want to bind an instance of urxvt256c-mld to the lifetime of a specific display/server. If the server does a reset, urxvt256c-mld will be killed automatically.
- -f, --fork
- This makes urxvt256c-mld fork after it has bound itself to its control socket.
- -m, --mlock
This makes urxvt256c-mld call mlockall(2) on itself. This locks
urxvt256c-mld in RAM and prevents it from being swapped out to disk,
at the cost of consuming a lot more memory on most operating systems.
Note: In order to use this feature, your system administrator must have set your user's RLIMIT_MEMLOCK to a size greater than or equal to the size of the urxvt256c-mld binary (or to unlimited). See /etc/security/limits.conf.
Note 2: There is a known bug in glibc (possibly fixed in 2.8 and later versions) where calloc returns non-zeroed memory when mlockall is in effect. If you experience crashes or other odd behaviour while using --mlock, try it without it.
- -e, --eval perlstring
Evaluate the given perl code after basic initialisation (requires perl
support to be enabled when compiling urxvt256c-mld).
This can be used for example to configure the internal perl interpreter, which is shared between all terminal instances, or create additional listening sockets for additional protocols.
The code is currently executed before creating the normal listening sockets: this might change in future versions.
EXAMPLESThis is a useful invocation of urxvt256c-mld in a .xsession-style script:
urxvt256c-mld -q -f -o
This waits till the control socket is available, opens the current display and forks into the background. When you log-out, the server is reset and urxvt256c-mld is killed.
- Both urxvt256c-mlc and urxvt256c-mld use the environment variable RXVT_SOCKET to create a listening socket and to contact the urxvt256c-mld, respectively. If the variable is missing then $HOME/.urxvt/urxvtd-<nodename> is used.
- Only used when the "--opendisplay" option is specified. Must contain a valid X display name.
SEE ALSOurxvt256c-ml(7), urxvt256c-mlc(1)