ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvtd.1.html
Revision: 1.5
Committed: Thu Nov 2 17:37:47 2006 UTC (17 years, 8 months ago) by root
Content type: text/html
Branch: MAIN
CVS Tags: rel-8_0, rel-8_1, rel-8_2
Changes since 1.4: +19 -19 lines
Log Message: 
*** empty log message ***

File Contents

# User Rev Content
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.5 <title>rxvtd - rxvt terminal daemon</title>
6 root 1.4 <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     <li><a href="#examples">EXAMPLES</a></li>
22     <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.5 <p>rxvtd - rxvt terminal daemon</p>
32 root 1.1 <p>
33     </p>
34     <hr />
35     <h1><a name="synopsis">SYNOPSIS</a></h1>
36 root 1.5 <p><strong>rxvtd</strong> [-q|--quiet] [-o|--opendisplay] [-f|--fork]</p>
37 root 1.1 <p>
38     </p>
39     <hr />
40     <h1><a name="description">DESCRIPTION</a></h1>
41 root 1.5 <p>This manpage describes the rxvtd daemon, which is the same vt102
42     terminal emulator as rxvt, but runs as a daemon that can open
43 root 1.1 multiple terminal windows within the same process.</p>
44     <p>You can run it from your X startup scripts, for example, although it is
45     not dependent on a working DISPLAY and, in fact, can open windows on
46     multiple X displays on the same time.</p>
47 root 1.5 <p>Advantages of running a rxvt daemon include faster creation time
48 root 1.1 for terminal windows and a lot of saved memory.</p>
49     <p>The disadvantage is a possible impact on stability - if the
50     main program crashes, all processes in the terminal windows are
51     terminated. For example, as there is no way to cleanly react to abnormal
52     connection closes, <code>xkill</code> and server resets/restarts will kill the
53 root 1.5 <strong>rxvtd</strong> instance including all windows it has opened.</p>
54 root 1.1 <p>
55     </p>
56     <hr />
57     <h1><a name="options">OPTIONS</a></h1>
58 root 1.5 <p><strong>rxvtd</strong> currently understands a few options only. Bundling of
59 root 1.1 options is not yet supported.</p>
60     <dl>
61 root 1.4 <dt><strong><a name="item__2dq_2c__2d_2dquiet"><strong>-q</strong>, <strong>--quiet</strong></a></strong>
62    
63 root 1.1 <dd>
64 root 1.5 <p>Normally, <strong>rxvtd</strong> outputs the message <code>rxvt-unicode daemon
65 root 1.1 listening on &lt;path&gt;</code> after binding to its control socket. This option
66 root 1.4 will suppress this message (errors and warnings will still be logged).</p>
67 root 1.1 </dd>
68 root 1.4 </li>
69     <dt><strong><a name="item__2do_2c__2d_2dopendisplay"><strong>-o</strong>, <strong>--opendisplay</strong></a></strong>
70    
71 root 1.1 <dd>
72 root 1.5 <p>This forces <strong>rxvtd</strong> to open a connection to the current
73 root 1.4 <code>$DISPLAY</code> and keep it open.</p>
74 root 1.1 </dd>
75     <dd>
76 root 1.5 <p>This is useful if you want to bind an instance of <strong>rxvtd</strong> to
77 root 1.1 the lifetime of a specific display/server. If the server does a reset,
78 root 1.5 <strong>rxvtd</strong> will be killed automatically.</p>
79 root 1.1 </dd>
80 root 1.4 </li>
81     <dt><strong><a name="item__2df_2c__2d_2dfork"><strong>-f</strong>, <strong>--fork</strong></a></strong>
82    
83 root 1.1 <dd>
84 root 1.5 <p>This makes <strong>rxvtd</strong> fork after it has bound itself to its control
85 root 1.4 socket.</p>
86 root 1.1 </dd>
87 root 1.4 </li>
88     </dl>
89 root 1.1 <p>
90     </p>
91     <hr />
92     <h1><a name="examples">EXAMPLES</a></h1>
93 root 1.5 <p>This is a useful invocation of <strong>rxvtd</strong> in a <em>.xsession</em>-style
94 root 1.1 script:</p>
95     <pre>
96 root 1.5 rxvtd -q -f -o</pre>
97 root 1.1 <p>This waits till the control socket is available, opens the current display
98     and forks into the background. When you log-out, the server is reset and
99 root 1.5 <strong>rxvtd</strong> is killed.</p>
100 root 1.1 <p>
101     </p>
102     <hr />
103     <h1><a name="environment">ENVIRONMENT</a></h1>
104     <dl>
105 root 1.4 <dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong>
106    
107 root 1.1 <dd>
108 root 1.5 <p>Both <strong>rxvtc</strong> and <strong>rxvtd</strong> use the environment
109 root 1.3 variable <em>RXVT_SOCKET</em> to create a listening socket and to contact
110 root 1.5 the rxvtd, respectively. If the variable is missing,
111 root 1.3 <em>$HOME/.rxvt-unicode-<em>&lt;nodename</em> </em>&gt; &gt;&gt;&gt; is used. The variable must
112 root 1.4 specify the absolute path of the socket to create.</p>
113 root 1.1 </dd>
114 root 1.4 </li>
115     <dt><strong><a name="item_display"><strong>DISPLAY</strong></a></strong>
116    
117 root 1.1 <dd>
118 root 1.4 <p>Only used when the <code>--opendisplay</code> option is specified. Must contain a
119     valid X display name.</p>
120 root 1.1 </dd>
121     </dl>
122     <p>
123     </p>
124     <hr />
125     <h1><a name="see_also">SEE ALSO</a></h1>
126 root 1.5 <p>rxvt(7), <code>rxvtc(1)</code></p>
127 root 1.1
128     </body>
129    
130     </html>