1urxvt(1)                         RXVT-UNICODE                         urxvt(1)
2
3
4

NAME

6       urxvtc - control the urxvtd daemon
7

SYNOPSIS

9       urxvtc [same options as for urxvt]
10

DESCRIPTION

12       This manpage describes the urxvtc client program. It connects to the
13       urxvtd daemon and requests a new terminal window. It takes the same
14       arguments as the urxvt program. The environment will also be respected.
15       Currently, it always returns immediately after contacting the daemon.
16

OPTIONS

18       If the first option is -k, urxvtc tries to kill the daemon process and
19       returns.
20
21       All options that are valid for urxvt are valid for urxvtc, too. Please
22       note that options are interpreted in the context of the daemon process.
23       However, as current working directory, process environment and any file
24       descriptor (e.g. for "-pty-fd") are preserved, this rarely makes a
25       difference.
26

EXIT STATUS

28       If everything went well, urxvtc returns with an exit status of 0.  If
29       contacting the daemon fails, it exits with the exit status 2. In all
30       other error cases it returns with status 1.
31
32       This can be used to implement auto-starting behaviour, by checking for
33       an exit status of 2, running "urxvtd -f -q" and retrying the call to
34       urxvtc, like this:
35
36          #!/bin/sh
37          urxvtc "$@"
38          if [ $? -eq 2 ]; then
39             urxvtd -q -o -f
40             urxvtc "$@"
41          fi
42

ENVIRONMENT

44       All environment variables of the current process will be made available
45       to the new instance, and will be interpreted as if urxvt were started
46       directly.
47
48       RXVT_SOCKET
49           Both urxvtc and urxvtd use the environment variable RXVT_SOCKET to
50           create a listening socket and to contact the urxvtd, respectively.
51           If the variable is missing, $HOME/.urxvt/urxvtd-<nodename> is used.
52           The variable must specify the absolute path of the socket to
53           create.
54

SEE ALSO

56       urxvt(7), urxvtd(1)
57
58
59
609.31                              2023-01-02                          urxvt(1)
Impressum