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