ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvtc.1.txt
Revision: 1.7
Committed: Sat Oct 27 12:09:02 2007 UTC (16 years, 9 months ago) by root
Content type: text/plain
Branch: MAIN
CVS Tags: rel-8_5a, rel-8_4, rel-8_6, rel-8_7
Changes since 1.6: +19 -18 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
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