1 | .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14 |
1 | .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) |
2 | .\" |
2 | .\" |
3 | .\" Standard preamble: |
3 | .\" Standard preamble: |
4 | .\" ======================================================================== |
4 | .\" ======================================================================== |
5 | .de Sh \" Subsection heading |
|
|
6 | .br |
|
|
7 | .if t .Sp |
|
|
8 | .ne 5 |
|
|
9 | .PP |
|
|
10 | \fB\\$1\fR |
|
|
11 | .PP |
|
|
12 | .. |
|
|
13 | .de Sp \" Vertical space (when we can't use .PP) |
5 | .de Sp \" Vertical space (when we can't use .PP) |
14 | .if t .sp .5v |
6 | .if t .sp .5v |
15 | .if n .sp |
7 | .if n .sp |
16 | .. |
8 | .. |
17 | .de Vb \" Begin verbatim text |
9 | .de Vb \" Begin verbatim text |
… | |
… | |
23 | .ft R |
15 | .ft R |
24 | .fi |
16 | .fi |
25 | .. |
17 | .. |
26 | .\" Set up some character translations and predefined strings. \*(-- will |
18 | .\" Set up some character translations and predefined strings. \*(-- will |
27 | .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
19 | .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
28 | .\" double quote, and \*(R" will give a right double quote. | will give a |
20 | .\" double quote, and \*(R" will give a right double quote. \*(C+ will |
29 | .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
21 | .\" give a nicer C++. Capital omega is used to do unbreakable dashes and |
30 | .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
22 | .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, |
31 | .\" expand to `' in nroff, nothing in troff, for use with C<>. |
23 | .\" nothing in troff, for use with C<>. |
32 | .tr \(*W-|\(bv\*(Tr |
24 | .tr \(*W- |
33 | .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
25 | .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
34 | .ie n \{\ |
26 | .ie n \{\ |
35 | . ds -- \(*W- |
27 | . ds -- \(*W- |
36 | . ds PI pi |
28 | . ds PI pi |
37 | . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
29 | . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
… | |
… | |
46 | . ds PI \(*p |
38 | . ds PI \(*p |
47 | . ds L" `` |
39 | . ds L" `` |
48 | . ds R" '' |
40 | . ds R" '' |
49 | 'br\} |
41 | 'br\} |
50 | .\" |
42 | .\" |
|
|
43 | .\" Escape single quotes in literal strings from groff's Unicode transform. |
|
|
44 | .ie \n(.g .ds Aq \(aq |
|
|
45 | .el .ds Aq ' |
|
|
46 | .\" |
51 | .\" If the F register is turned on, we'll generate index entries on stderr for |
47 | .\" If the F register is turned on, we'll generate index entries on stderr for |
52 | .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
48 | .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index |
53 | .\" entries marked with X<> in POD. Of course, you'll have to process the |
49 | .\" entries marked with X<> in POD. Of course, you'll have to process the |
54 | .\" output yourself in some meaningful fashion. |
50 | .\" output yourself in some meaningful fashion. |
55 | .if \nF \{\ |
51 | .ie \nF \{\ |
56 | . de IX |
52 | . de IX |
57 | . tm Index:\\$1\t\\n%\t"\\$2" |
53 | . tm Index:\\$1\t\\n%\t"\\$2" |
58 | .. |
54 | .. |
59 | . nr % 0 |
55 | . nr % 0 |
60 | . rr F |
56 | . rr F |
61 | .\} |
57 | .\} |
62 | .\" |
58 | .el \{\ |
63 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
59 | . de IX |
64 | .\" way too many mistakes in technical documents. |
60 | .. |
65 | .hy 0 |
61 | .\} |
66 | .if n .na |
|
|
67 | .\" |
62 | .\" |
68 | .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
63 | .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
69 | .\" Fear. Run. Save yourself. No user-serviceable parts. |
64 | .\" Fear. Run. Save yourself. No user-serviceable parts. |
70 | . \" fudge factors for nroff and troff |
65 | . \" fudge factors for nroff and troff |
71 | .if n \{\ |
66 | .if n \{\ |
… | |
… | |
126 | . ds Ae AE |
121 | . ds Ae AE |
127 | .\} |
122 | .\} |
128 | .rm #[ #] #H #V #F C |
123 | .rm #[ #] #H #V #F C |
129 | .\" ======================================================================== |
124 | .\" ======================================================================== |
130 | .\" |
125 | .\" |
131 | .IX Title "rxvt 1" |
126 | .IX Title "@@RXVT_NAME@@ 1" |
132 | .TH rxvt 1 "2005-07-07" "5.6" "RXVT-UNICODE" |
127 | .TH @@RXVT_NAME@@ 1 "2012-01-21" "@@RXVT_VERSION@@" "RXVT-UNICODE" |
|
|
128 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
|
129 | .\" way too many mistakes in technical documents. |
|
|
130 | .if n .ad l |
|
|
131 | .nh |
133 | .SH "NAME" |
132 | .SH "NAME" |
134 | @@RXVT_NAME@@c \- control the @@RXVT_NAME@@d daemon |
133 | @@RXVT_NAME@@c \- control the @@RXVT_NAME@@d daemon |
135 | .SH "SYNOPSIS" |
134 | .SH "SYNOPSIS" |
136 | .IX Header "SYNOPSIS" |
135 | .IX Header "SYNOPSIS" |
137 | \&\fB@@RXVT_NAME@@c\fR [same options as for @@RXVT_NAME@@] |
136 | \&\fB@@RXVT_NAME@@c\fR [same options as for @@RXVT_NAME@@] |
… | |
… | |
143 | will also be respected. Currently, it always returns immediately after |
142 | will also be respected. Currently, it always returns immediately after |
144 | contacting the daemon. |
143 | contacting the daemon. |
145 | .SH "OPTIONS" |
144 | .SH "OPTIONS" |
146 | .IX Header "OPTIONS" |
145 | .IX Header "OPTIONS" |
147 | All options that are valid for \fB@@RXVT_NAME@@\fR are valid for |
146 | All options that are valid for \fB@@RXVT_NAME@@\fR are valid for |
148 | \&\fB@@RXVT_NAME@@c\fR, too. Please note that all options are currently |
147 | \&\fB@@RXVT_NAME@@c\fR, too. Please note that options are interpreted in the |
149 | interpreted in the context of the daemon process, which makes a difference |
148 | context of the daemon process. However, as current working directory, |
150 | for options that specify a file descriptor (such as \fB\-pty\-fd\fR). |
149 | process environment and any file descriptor (e.g. for \f(CW\*(C`\-pty\-fd\*(C'\fR) are |
|
|
150 | preserved, this rarely makes a difference. |
|
|
151 | .SH "EXIT STATUS" |
|
|
152 | .IX Header "EXIT STATUS" |
|
|
153 | If everything went well, @@RXVT_NAME@@c returns with an exit status of \f(CW0\fR. |
|
|
154 | If contacting the daemon fails, it exits with the exit status \f(CW2\fR. In all other error |
|
|
155 | cases it returns with status \f(CW1\fR. |
|
|
156 | .PP |
|
|
157 | This can be used to implement auto-starting behaviour, by checking for an |
|
|
158 | exit status of \f(CW2\fR, running \f(CW\*(C`@@RXVT_NAME@@d \-f \-q\*(C'\fR and retrying the call |
|
|
159 | to @@RXVT_NAME@@c, like this: |
|
|
160 | .PP |
|
|
161 | .Vb 6 |
|
|
162 | \& #!/bin/sh |
|
|
163 | \& @@RXVT_NAME@@c "$@" |
|
|
164 | \& if [ $? \-eq 2 ]; then |
|
|
165 | \& @@RXVT_NAME@@d \-q \-o \-f |
|
|
166 | \& @@RXVT_NAME@@c "$@" |
|
|
167 | \& fi |
|
|
168 | .Ve |
151 | .SH "ENVIRONMENT" |
169 | .SH "ENVIRONMENT" |
152 | .IX Header "ENVIRONMENT" |
170 | .IX Header "ENVIRONMENT" |
153 | All environment variables of the current process will be made available |
171 | All environment variables of the current process will be made available |
154 | to the new instance, and will be interpreted as if \fB@@RXVT_NAME@@\fR were |
172 | to the new instance, and will be interpreted as if \fB@@RXVT_NAME@@\fR were |
155 | started directly. |
173 | started directly. |
156 | .IP "\fB\s-1RXVT_SOCKET\s0\fR" 4 |
174 | .IP "\fB\s-1RXVT_SOCKET\s0\fR" 4 |
157 | .IX Item "RXVT_SOCKET" |
175 | .IX Item "RXVT_SOCKET" |
158 | Both @@RXVT_NAME@@c and @@RXVT_NAME@@d use the environment variable |
176 | Both @@RXVT_NAME@@c and @@RXVT_NAME@@d use the environment variable |
159 | \&\fI\s-1RXVT_SOCKET\s0\fR to create a listening socket and to contact |
177 | \&\fI\s-1RXVT_SOCKET\s0\fR to create a listening socket and to contact the |
160 | the @@RXVT_NAME@@d, respectively. If the variable is missing, |
178 | @@RXVT_NAME@@d, respectively. If the variable is missing, |
161 | \&\fI$HOME/.rxvt\-unicode\-\fI<nodename>\fI\fR is used. |
179 | \&\fI\f(CI$HOME\fI/.urxvt/urxvtd\-\fI<nodename>\fI\fR is used. The variable must |
|
|
180 | specify the absolute path of the socket to create. |
162 | .SH "SEE ALSO" |
181 | .SH "SEE ALSO" |
163 | .IX Header "SEE ALSO" |
182 | .IX Header "SEE ALSO" |
164 | @@RXVT_NAME@@(7), @@RXVT_NAME@@d(1) |
183 | @@RXVT_NAME@@(7), @@RXVT_NAME@@d(1) |