summaryrefslogtreecommitdiffstats
path: root/doc/rxvtc.1.pod
blob: 3712dd4376f0a8faaaaabad7c271360286c3d3b3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
=head1 NAME

@@RXVT_NAME@@c - control the @@RXVT_NAME@@d daemon

=head1 SYNOPSIS

B<@@RXVT_NAME@@c> [same options as for @@RXVT_NAME@@]

=head1 DESCRIPTION

This manpage describes the B<@@RXVT_NAME@@c> client program. It connects
to the B<@@RXVT_NAME@@d> daemon and requests a new terminal window. It
takes the same arguments as the B<@@RXVT_NAME@@> program. The environment
will also be respected. Currently, it always returns immediately after
contacting the daemon.

=head1 OPTIONS

If the first option is B<-k>, B<@@RXVT_NAME@@c> tries to kill the
daemon process and returns.

All options that are valid for B<@@RXVT_NAME@@> are valid for
B<@@RXVT_NAME@@c>, too. Please note that options are interpreted in the
context of the daemon process. However, as current working directory,
process environment and any file descriptor (e.g. for C<-pty-fd>) are
preserved, this rarely makes a difference.

=head1 EXIT STATUS

If everything went well, @@RXVT_NAME@@c returns with an exit status of C<0>.
If contacting the daemon fails, it exits with the exit status C<2>. In all other error
cases it returns with status C<1>.

This can be used to implement auto-starting behaviour, by checking for an
exit status of C<2>, running C<@@RXVT_NAME@@d -f -q> and retrying the call
to @@RXVT_NAME@@c, like this:

   #!/bin/sh
   @@RXVT_NAME@@c "$@"
   if [ $? -eq 2 ]; then
      @@RXVT_NAME@@d -q -o -f
      @@RXVT_NAME@@c "$@"
   fi

=head1 ENVIRONMENT

All environment variables of the current process will be made available
to the new instance, and will be interpreted as if B<@@RXVT_NAME@@> were
started directly.

=over 4

=item B<RXVT_SOCKET>

Both @@RXVT_NAME@@c and @@RXVT_NAME@@d use the environment variable
F<RXVT_SOCKET> to create a listening socket and to contact the
@@RXVT_NAME@@d, respectively. If the variable is missing,
F<<< $HOME/.urxvt/urxvtd-I<< <nodename> >> >>> is used.  The variable must
specify the absolute path of the socket to create.

=back

=head1 SEE ALSO

@@RXVT_NAME@@(7), @@RXVT_NAME@@d(1)