GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  URXVTC (1)

.ds Aq ’

NAME

urxvtc - control the urxvtd daemon

CONTENTS

SYNOPSIS

urxvtc [same options as for urxvt]

DESCRIPTION

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 will also be respected. Currently, it always returns immediately after contacting the daemon.

OPTIONS

If the first option is -k, urxvtc tries to kill the daemon process and returns.

All options that are valid for urxvt are valid for urxvtc, 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 -pty-fd) are preserved, this rarely makes a difference.

EXIT STATUS

If everything went well, urxvtc returns with an exit status of 0. If contacting the daemon fails, it exits with the exit status 2. In all other error cases it returns with status 1.

This can be used to implement auto-starting behaviour, by checking for an exit status of 2, running urxvtd -f -q and retrying the call to urxvtc, like this:



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



ENVIRONMENT

All environment variables of the current process will be made available to the new instance, and will be interpreted as if urxvt were started directly.
RXVT_SOCKET Both urxvtc and urxvtd use the environment variable RXVT_SOCKET to create a listening socket and to contact the urxvtd, respectively. If the variable is missing, $HOME/.urxvt/urxvtd-<nodename> is used. The variable must specify the absolute path of the socket to create.

SEE ALSO

urxvt(7), urxvtd(1)
Search for    or go to Top of page |  Section 1 |  Main Index


9.22 URXVT (1) 2016-01-23

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.