1 |
root |
1.4 |
<?xml version="1.0" ?> |
2 |
root |
1.1 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
3 |
|
|
<html xmlns="http://www.w3.org/1999/xhtml"> |
4 |
|
|
<head> |
5 |
root |
1.4 |
<title>urxvtc - control the urxvtd daemon</title> |
6 |
|
|
<meta http-equiv="content-type" content="text/html; charset=utf-8" /> |
7 |
root |
1.1 |
<link rev="made" href="mailto:perl-binary@plan9.de" /> |
8 |
|
|
</head> |
9 |
|
|
|
10 |
|
|
<body style="background-color: white"> |
11 |
|
|
|
12 |
|
|
<p><a name="__index__"></a></p> |
13 |
|
|
<!-- INDEX BEGIN --> |
14 |
|
|
|
15 |
|
|
<ul> |
16 |
|
|
|
17 |
|
|
<li><a href="#name">NAME</a></li> |
18 |
|
|
<li><a href="#synopsis">SYNOPSIS</a></li> |
19 |
|
|
<li><a href="#description">DESCRIPTION</a></li> |
20 |
|
|
<li><a href="#options">OPTIONS</a></li> |
21 |
root |
1.3 |
<li><a href="#exit_status">EXIT STATUS</a></li> |
22 |
root |
1.1 |
<li><a href="#environment">ENVIRONMENT</a></li> |
23 |
|
|
<li><a href="#see_also">SEE ALSO</a></li> |
24 |
|
|
</ul> |
25 |
|
|
<!-- INDEX END --> |
26 |
|
|
|
27 |
|
|
<hr /> |
28 |
|
|
<p> |
29 |
|
|
</p> |
30 |
|
|
<h1><a name="name">NAME</a></h1> |
31 |
root |
1.4 |
<p>urxvtc - control the urxvtd daemon</p> |
32 |
root |
1.1 |
<p> |
33 |
|
|
</p> |
34 |
|
|
<hr /> |
35 |
|
|
<h1><a name="synopsis">SYNOPSIS</a></h1> |
36 |
root |
1.4 |
<p><strong>urxvtc</strong> [same options as for urxvt]</p> |
37 |
root |
1.1 |
<p> |
38 |
|
|
</p> |
39 |
|
|
<hr /> |
40 |
|
|
<h1><a name="description">DESCRIPTION</a></h1> |
41 |
root |
1.4 |
<p>This manpage describes the <strong>urxvtc</strong> client program. It connects |
42 |
|
|
to the <strong>urxvtd</strong> daemon and requests a new terminal window. It |
43 |
|
|
takes the same arguments as the <strong>urxvt</strong> program. The environment |
44 |
root |
1.1 |
will also be respected. Currently, it always returns immediately after |
45 |
|
|
contacting the daemon.</p> |
46 |
|
|
<p> |
47 |
|
|
</p> |
48 |
|
|
<hr /> |
49 |
|
|
<h1><a name="options">OPTIONS</a></h1> |
50 |
root |
1.4 |
<p>All options that are valid for <strong>urxvt</strong> are valid for |
51 |
|
|
<strong>urxvtc</strong>, too. Please note that all options are currently |
52 |
root |
1.1 |
interpreted in the context of the daemon process, which makes a difference |
53 |
|
|
for options that specify a file descriptor (such as <strong>-pty-fd</strong>).</p> |
54 |
|
|
<p> |
55 |
|
|
</p> |
56 |
|
|
<hr /> |
57 |
root |
1.3 |
<h1><a name="exit_status">EXIT STATUS</a></h1> |
58 |
root |
1.4 |
<p>If everything went well, urxvtc returns with an exit status of <code>0</code>. |
59 |
root |
1.3 |
If contacting the daemon fails, it exits with the exit status <code>2</code>. In all other error |
60 |
|
|
cases it returns with status <code>1</code>.</p> |
61 |
|
|
<p>This can be used to implement auto-starting behaviour, by checking for an |
62 |
root |
1.4 |
exit status of <code>2</code>, running <code>urxvtd -f -q</code> and retrying the call |
63 |
|
|
to urxvtc.</p> |
64 |
root |
1.3 |
<p> |
65 |
|
|
</p> |
66 |
|
|
<hr /> |
67 |
root |
1.1 |
<h1><a name="environment">ENVIRONMENT</a></h1> |
68 |
|
|
<p>All environment variables of the current process will be made available |
69 |
root |
1.4 |
to the new instance, and will be interpreted as if <strong>urxvt</strong> were |
70 |
root |
1.1 |
started directly.</p> |
71 |
|
|
<dl> |
72 |
root |
1.4 |
<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong> |
73 |
|
|
|
74 |
root |
1.1 |
<dd> |
75 |
root |
1.4 |
<p>Both urxvtc and urxvtd use the environment variable |
76 |
root |
1.2 |
<em>RXVT_SOCKET</em> to create a listening socket and to contact the |
77 |
root |
1.4 |
urxvtd, respectively. If the variable is missing, |
78 |
root |
1.2 |
<em>$HOME/.rxvt-unicode-<em><nodename</em> </em>> >>> is used. The variable must |
79 |
root |
1.4 |
specify the absolute path of the socket to create.</p> |
80 |
root |
1.1 |
</dd> |
81 |
root |
1.4 |
</li> |
82 |
|
|
</dl> |
83 |
root |
1.1 |
<p> |
84 |
|
|
</p> |
85 |
|
|
<hr /> |
86 |
|
|
<h1><a name="see_also">SEE ALSO</a></h1> |
87 |
root |
1.4 |
<p>urxvt(7), <code>urxvtd(1)</code></p> |
88 |
root |
1.1 |
|
89 |
|
|
</body> |
90 |
|
|
|
91 |
|
|
</html> |