Differential D10640 Diff 28185 head/usr.bin/resizewin/resizewin.1

Changeset View

Standalone View

head/usr.bin/resizewin/resizewin.1

	Show All 21 Lines
	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)			.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd May 8, 2017			.Dd May 9, 2017
	.Dt RESIZEWIN 1			.Dt RESIZEWIN 1
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm resizewin			.Nm resizewin
	.Nd update the kernel window size for the current TTY			.Nd update terminal size
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm			.Nm
	.Op Fl z			.Op Fl z
	.Sh DESCRIPTION			.Sh DESCRIPTION
	Query the terminal emulator window size with the			The
				.Nm
				utility
				queries the terminal emulator for the current window size and updates
				the size known to the kernel using the
	.Dv TIOCSWINSZ			.Dv TIOCSWINSZ
	ioctl and set the window size known by the kernel to the new values.			ioctl.
	The terminal is assumed to be VT100/ANSI compatible.
	.Pp			.Pp
	The following options are available:			The following options are available:
	.Bl -tag -width ".Fl z"			.Bl -tag -width ".Fl z"
	.It Fl z			.It Fl z
	Do nothing unless the current kernel terminal size is zero.			Do nothing unless the current kernel terminal size is zero.
				This is useful when run from user's profile (shell startup) scripts:
				wblockUnsubmitted Not Done Inline Actions s/from/from a/ I don't understand the use of the colon at all. Running from a startup script has nothing to do with whether it's serial or some other connection type. So break up this sentence: This is useful when run from a user's profile (shell startup) scripts. Querying the window size is required for serial lines, but not when wblock: s/from/from a/ I don't understand the use of the colon at all. Running from a startup script…
				traszAuthorUnsubmitted Not Done Inline Actions The connection is that differently from when you run it by hand - because only do that when it's actually needed - when run from shell startup scripts it runs in cases when it's not needed, ie cases other than serial terminal. trasz: The connection is that differently from when you run it by hand - because only do that when…
				querying the window size is required for serial lines, but not when
				logging in over the network, as protocols like TELNET or SSH already
				handle the terminal size by themselves.
	.El			.El
	.Pp			.Pp
				After a terminal window has been resized, running
	.Nm			.Nm
				updates the kernel's window size to match the new size.
				.Pp
				.Nm
	is functionally similar to			is functionally similar to
	.Xr resize 1 ,			.Xr resize 1 ,
	which is part of the			which is part of the
	.Xr xterm 1			.Xr xterm 1
	distribution.			distribution.
	However,			However,
	.Nm			.Nm
	only works with VT100/ANSI-compatible terminals and does			only works with VT100/ANSI-compatible terminals and directly sets
	not emit commands to set environment variables.			the terminal size instead of emitting commands to set environment variables.
	.Pp			.Pp
	After a terminal window has been resized, running			The terminal is assumed to be VT100/ANSI compatible.
	.Nm			The VT100/ANSI escape sequences are supported by virtually all modern
	updates the kernel's window size to match the new size.			terminals; this include xterm, konsole, gnome-terminal, iTerm,
				wblockUnsubmitted Not Done Inline Actions s/; this include/, including/ wblock: s/; this include/, including/
	.Pp
	Note that virtually all modern terninals support VT100/ANSI escape
	sequences, including xterm, konsole, gnome-terminal iTerm,
	Terminal.app, and PuTTY.			Terminal.app, and PuTTY.
	.Sh SEE ALSO			.Sh SEE ALSO
	.Xr resize 1 ,			.Xr stty 1 ,
	.Xr stty 1			.Xr tty 4
	.Sh HISTORY			.Sh HISTORY
	The			The
	.Nm			.Nm
	command first appeared in			command first appeared in
	.Fx 11 .			.Fx 11.0 .