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

FreeBSD Manual Pages

  
 
  

home | help
VCRTTY(1)		  BSD 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	trying
	     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 error.

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>

BSD				 March 2, 2011				   BSD

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ENVIRONMENT | FILES | EXAMPLES | SEE ALSO | HISTORY | AUTHORS

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

home | help