1urxvt-ml(1) RXVT-UNICODE urxvt-ml(1)
2
3
4
6 urxvt-mlc - control the urxvt-mld daemon
7
9 urxvt-mlc [same options as for urxvt-ml]
10
12 This manpage describes the urxvt-mlc client program. It connects to the
13 urxvt-mld daemon and requests a new terminal window. It takes the same
14 arguments as the urxvt-ml program. The environment will also be
15 respected. Currently, it always returns immediately after contacting
16 the daemon.
17
19 If the first option is -k, urxvt-mlc tries to kill the daemon process
20 and returns.
21
22 All options that are valid for urxvt-ml are valid for urxvt-mlc, too.
23 Please note that options are interpreted in the context of the daemon
24 process. However, as current working directory, process environment and
25 any file descriptor (e.g. for "-pty-fd") are preserved, this rarely
26 makes a difference.
27
29 If everything went well, urxvt-mlc returns with an exit status of 0.
30 If contacting the daemon fails, it exits with the exit status 2. In all
31 other error cases it returns with status 1.
32
33 This can be used to implement auto-starting behaviour, by checking for
34 an exit status of 2, running "urxvt-mld -f -q" and retrying the call to
35 urxvt-mlc, like this:
36
37 #!/bin/sh
38 urxvt-mlc "$@"
39 if [ $? -eq 2 ]; then
40 urxvt-mld -q -o -f
41 urxvt-mlc "$@"
42 fi
43
45 All environment variables of the current process will be made available
46 to the new instance, and will be interpreted as if urxvt-ml were
47 started directly.
48
49 RXVT_SOCKET
50 Both urxvt-mlc and urxvt-mld use the environment variable
51 RXVT_SOCKET to create a listening socket and to contact the urxvt-
52 mld, respectively. If the variable is missing,
53 $HOME/.urxvt/urxvtd-<nodename> is used. The variable must specify
54 the absolute path of the socket to create.
55
57 urxvt-ml(7), urxvt-mld(1)
58
59
60
619.22 2016-01-23 urxvt-ml(1)