Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
VCRTTY(1)		    General Commands Manual		     VCRTTY(1)

NAME
       vcrtty -- try to	find a terminal-like name for the current session

SYNOPSIS
       vcrtty

DESCRIPTION
       The  vcrtty  utility examines the current session and tries to find the
       name of a terminal or something similar	that  could  describe  it  for
       tools like vcr(1) that do different things on different terminals.  The
       vcrtty utility tries the	following in succession:

       *       If the TTY environment variable is set, vcrtty outputs its con-
	       tents.

       *       If the tty(1) command may be executed successfully, vcrtty out-
	       puts its	result.

       *       If the DISPLAY environment variable is set, vcrtty assumes that
	       this is a X session and outputs a "xdesktopN" string after try-
	       ing  to	determine  which  X desktop it is running on; for this
	       purpose,	the wmctrl(1) tool is used if available.

       *       Otherwise vcrtty	does not output	anything at all; it is	up  to
	       the  invoking program to	decide whether to treat	this as	an er-
	       ror.

RETURN VALUES
       The vcrtty utility exits	0 on success, and >0 if	an error occurs.

ENVIRONMENT
       The vcrtty utility examines the TTY and DISPLAY	environment  variables
       as  outlined  above.   Also, the	PATH variable may affect its operation
       when invoking tty(1) or wmctrl(1).

FILES
       The vcrtty utility's operation is not directly affected by any files.

EXAMPLES
       Well, just do it	- output a usable TTY name:

	     vcrtty

SEE ALSO
       tty(1), vcr(1), wmctrl(1)

HISTORY
       The vcrtty utility was written by Peter Pentchev	in 2011.

AUTHORS
       Peter Penchev <roam@ringlet.net>

FreeBSD	ports 15.0		 March 2, 2011			     VCRTTY(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=vcrtty&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help