resize manpage

Search topic Section

RESIZE(1)			X Window System			     RESIZE(1)

       resize  - set environment and terminal settings to current xterm window

       resize [ -v | -u | -c ] [ -s [ row col ] ]

       Resize prints a shell command for setting the  appropriate  environment
       variables  to  indicate the current size of xterm window from which the
       command is run.

       Resize determines the command through several steps:

       o   first, it finds the name of the user's shell program.  It uses  the
	   SHELL  variable  if	set,  otherwise	 it  uses the user's data from

       o   then it decides whether to use Bourne shell syntax or C-Shell  syn-
	   tax.	  It uses a built-in table of known shells, which can be over-
	   ridden by the -u and -c options.

       o   then resize asks the operating system for  the  terminal  settings.
	   This is the same information which can be manipulated using stty.

       o   then	 resize asks the terminal for its size in characters.  Depend-
	   ing on whether the "-s option is given,  resize  uses  a  different
	   escape sequence to ask for this information.

       o   at  this  point, resize attempts to update the terminal settings to
	   reflect the terminal window's size in pixels:

	   o   if the -s option is used, resize then asks the terminal for its
	       size in pixels.

	   o   otherwise, resize asks the operating system for the information
	       and updates that after ensuring that  the  window's  dimensions
	       are a multiple of the character height and width.

	   o   in  either case, the updated terminal settings are done using a
	       different system call than used for stty.

       o   then resize updates the terminal settings to	 reflect  any  altered
	   values  such as its size in rows or columns.	 This affects the val-
	   ues shown by stty.

       o   finally, resize writes the shell command for setting	 the  environ-
	   ment variables to the standard output.

       For  resize's output to take effect, resize must either be evaluated as
       part of the command line (usually done with a shell alias or  function)
       or  else	 redirected  to	 a file which can then be read in.  From the C
       shell (usually known as /bin/csh), the following alias could be defined
       in the user's .cshrc:

	       %  alias rs 'set noglob; eval `resize`'

       After resizing the window, the user would type:

	       %  rs

       Users  of  versions of the Bourne shell (usually known as /bin/sh) that
       don't have command functions will need to send the output to  a	tempo-
       rary file and then read it back in with the "." command:

	       $  resize > /tmp/out
	       $  . /tmp/out

       The following options may be used with resize:

       -c      This option indicates that C shell commands should be generated
	       even if the user's current shell is not /bin/csh.

       -s [rows columns]
	       This option indicates that Sun console escape sequences will be
	       used  instead  of  the VT100-style xterm escape codes.  If rows
	       and columns are given, resize will  ask	the  xterm  to	resize
	       itself using those values.

	       Both  of	 the  escape  sequences used for this option (first to
	       obtain the window size and second to modify it) are subject  to
	       xterm's	allowWindowOps	resource  setting.  The window manager
	       may also choose to disallow the change.

	       The VT100-style escape sequence used to	determine  the	screen
	       size  always works for VT100-compatible terminals.  VT100s have
	       no corresponding way to modify the screensize.

       -u      This option indicates that Bourne shell commands should be gen-
	       erated even if the user's current shell is not /bin/sh.

       -v      This  causes  resize  to print a version number to the standard
	       output, and then exit.

       Note that the Sun console escape sequences are  recognized  by  XFree86
       xterm  and  by dtterm.  The resize program may be installed as sunsize,
       which causes makes it assume the -s option.

       The rows and columns arguments must appear last; though they  are  nor-
       mally associated with the -s option, they are parsed separately.

       /etc/termcap   for the base termcap entry to modify.

       ~/.cshrc	      user's alias for the command.

       SHELL	      Resize  determines  the  user's  current	shell by first
		      checking if $SHELL is set, and using that.  Otherwise it
		      determines  the  user's shell by looking in the password
		      file  (/etc/passwd).   Generally	Bourne-shell  variants
		      (including  ksh) do not modify $SHELL, so it is possible
		      for resize to be confused if  one	 runs  resize  from  a
		      Bourne shell spawned from a C shell.

       TERM	      Resize sets this to "xterm" if not already set.

       TERMCAP	      Resize  sets  this  variable  on	systems using termcap,
		      e.g., when resize is linked  with	 the  termcap  library
		      rather  than  a  terminfo	 library.  The latter does not
		      provide the complete text for a termcap entry.

       COLUMNS, LINES Resize sets these variables on systems  using  terminfo.
		      Many  applications  (including  the  curses library) use
		      those variables when set to override their screensize.

       csh(1), stty(1), tset(1)

       Mark Vandevoorde (MIT-Athena), Edward Moy (Berkeley)
       Thomas Dickey (invisible-island.net).
       Copyright (c) 1984, 1985 by X Consortium
       See X(7) for a complete copyright notice.

Patch #295			  2013-07-06			     RESIZE(1)