From: root
urxvtc - control the urxvtd daemon rxvtc - control the rxvtd daemon
urxvtc [same options as for urxvt] rxvtc [same options as for rxvt]
This manpage describes the urxvtc client program. It connects
-to the urxvtd daemon and requests a new terminal window. It
-takes the same arguments as the urxvt program. The environment
+ This manpage describes the rxvtc client program. It connects
+to the rxvtd daemon and requests a new terminal window. It
+takes the same arguments as the rxvt program. The environment
will also be respected. Currently, it always returns immediately after
contacting the daemon.
All options that are valid for urxvt are valid for
-urxvtc, too. Please note that all options are currently
-interpreted in the context of the daemon process, which makes a difference
-for options that specify a file descriptor (such as -pty-fd). All options that are valid for rxvt are valid for
+rxvtc, too. Please note that options are interpreted in the
+context of the daemon process. However, as current working directory,
+process environment and any file handles (e.g. for
If everything went well, urxvtc returns with an exit status of If everything went well, rxvtc returns with an exit status of This can be used to implement auto-starting behaviour, by checking for an
-exit status of NAME
-
SYNOPSIS
-
DESCRIPTION
-
OPTIONS
--pty-fd
) are
+preserved, this rarely makes a difference.
EXIT STATUS
-0
.
+0
.
If contacting the daemon fails, it exits with the exit status 2
. In all other error
cases it returns with status 1
.2
, running urxvtd -f -q
and retrying the call
-to urxvtc.2
, running rxvtd -f -q
and retrying the call
+to rxvtc, like this:
+ #!/bin/sh + rxvtc "$@" + if [ $? -eq 2 ]; then + rxvtd -q -o -f + rxvtc "$@" + fi
All environment variables of the current process will be made available -to the new instance, and will be interpreted as if urxvt were +to the new instance, and will be interpreted as if rxvt were started directly.
Both urxvtc and urxvtd use the environment variable +
Both rxvtc and rxvtd use the environment variable RXVT_SOCKET to create a listening socket and to contact the -urxvtd, respectively. If the variable is missing, +rxvtd, respectively. If the variable is missing, $HOME/.rxvt-unicode-<nodename > >>> is used. The variable must specify the absolute path of the socket to create.
urxvt(7), urxvtd(1)
rxvt(7), rxvtd(1)