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