usr.bin/script/script.1

9b50d902SRodney W. Grimes.\" Copyright (c) 1980, 1990, 1993
9b50d902SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
9b50d902SRodney W. Grimes.\"
9b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
9b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions
9b50d902SRodney W. Grimes.\" are met:
9b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
9b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
9b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
9b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
9b50d902SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
9b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
9b50d902SRodney W. Grimes.\"    must display the following acknowledgement:
9b50d902SRodney W. Grimes.\"	This product includes software developed by the University of
9b50d902SRodney W. Grimes.\"	California, Berkeley and its contributors.
9b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
9b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
9b50d902SRodney W. Grimes.\"    without specific prior written permission.
9b50d902SRodney W. Grimes.\"
9b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
9b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
9b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
9b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
9b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
9b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
9b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
9b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
9b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
9b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
9b50d902SRodney W. Grimes.\" SUCH DAMAGE.
9b50d902SRodney W. Grimes.\"
9b50d902SRodney W. Grimes.\"	@(#)script.1	8.1 (Berkeley) 6/6/93
9b50d902SRodney W. Grimes.\"
9b50d902SRodney W. Grimes.Dd June 6, 1993
9b50d902SRodney W. Grimes.Dt SCRIPT 1
9b50d902SRodney W. Grimes.Os BSD 4
9b50d902SRodney W. Grimes.Sh NAME
9b50d902SRodney W. Grimes.Nm script
9b50d902SRodney W. Grimes.Nd make typescript of terminal session
9b50d902SRodney W. Grimes.Sh SYNOPSIS
9b50d902SRodney W. Grimes.Nm script
9b50d902SRodney W. Grimes.Op Fl a
9b50d902SRodney W. Grimes.Op Ar file
9b50d902SRodney W. Grimes.Sh DESCRIPTION
9b50d902SRodney W. Grimes.Nm Script
9b50d902SRodney W. Grimesmakes a typescript of everything printed on your terminal.
9b50d902SRodney W. GrimesIt is useful for students who need a hardcopy record of an interactive
9b50d902SRodney W. Grimessession as proof of an assignment, as the typescript file
9b50d902SRodney W. Grimescan be printed out later with
9b50d902SRodney W. Grimes.Xr lpr 1 .
9b50d902SRodney W. Grimes.Pp
9b50d902SRodney W. GrimesIf the argument
9b50d902SRodney W. Grimes.Ar file
9b50d902SRodney W. Grimesis given,
9b50d902SRodney W. Grimes.Nm
9b50d902SRodney W. Grimessaves all dialogue in
9b50d902SRodney W. Grimes.Ar file .
9b50d902SRodney W. GrimesIf no file name is given, the typescript is saved in the file
9b50d902SRodney W. Grimes.Pa typescript  .
9b50d902SRodney W. Grimes.Pp
9b50d902SRodney W. GrimesOption:
9b50d902SRodney W. Grimes.Bl -tag -width Ds
9b50d902SRodney W. Grimes.It Fl a
9b50d902SRodney W. GrimesAppend the output to
9b50d902SRodney W. Grimes.Ar file
9b50d902SRodney W. Grimesor
9b50d902SRodney W. Grimes.Pa typescript ,
9b50d902SRodney W. Grimesretaining the prior contents.
9b50d902SRodney W. Grimes.El
9b50d902SRodney W. Grimes.Pp
9b50d902SRodney W. GrimesThe script ends when the forked shell exits (a
9b50d902SRodney W. Grimes.Em control-D
9b50d902SRodney W. Grimesto exit
9b50d902SRodney W. Grimesthe Bourne shell
9b50d902SRodney W. Grimes.Pf ( Xr sh 1 ) ,
9b50d902SRodney W. Grimesand
9b50d902SRodney W. Grimes.Em exit ,
9b50d902SRodney W. Grimes.Em logout
9b50d902SRodney W. Grimesor
9b50d902SRodney W. Grimes.Em control-d
9b50d902SRodney W. Grimes(if
9b50d902SRodney W. Grimes.Em ignoreeof
9b50d902SRodney W. Grimesis not set) for the
9b50d902SRodney W. GrimesC-shell,
9b50d902SRodney W. Grimes.Xr csh 1 ) .
9b50d902SRodney W. Grimes.Pp
9b50d902SRodney W. GrimesCertain interactive commands, such as
9b50d902SRodney W. Grimes.Xr vi 1 ,
9b50d902SRodney W. Grimescreate garbage in the typescript file.
9b50d902SRodney W. Grimes.Nm Script
9b50d902SRodney W. Grimesworks best with commands that do not manipulate the
9b50d902SRodney W. Grimesscreen, the results are meant to emulate a hardcopy
9b50d902SRodney W. Grimesterminal.
9b50d902SRodney W. Grimes.Sh ENVIRONMENT
9b50d902SRodney W. GrimesThe following environment variable is utilized by
9b50d902SRodney W. Grimes.Nm script :
9b50d902SRodney W. Grimes.Bl -tag -width SHELL
9b50d902SRodney W. Grimes.It Ev SHELL
9b50d902SRodney W. GrimesIf the variable
9b50d902SRodney W. Grimes.Ev SHELL
9b50d902SRodney W. Grimesexists, the shell forked by
9b50d902SRodney W. Grimes.Nm script
9b50d902SRodney W. Grimeswill be that shell. If
9b50d902SRodney W. Grimes.Ev SHELL
9b50d902SRodney W. Grimesis not set, the Bourne shell
9b50d902SRodney W. Grimesis assumed. (Most shells set this variable automatically).
9b50d902SRodney W. Grimes.El
9b50d902SRodney W. Grimes.Sh SEE ALSO
9b50d902SRodney W. Grimes.Xr csh 1
9b50d902SRodney W. Grimes(for the
9b50d902SRodney W. Grimes.Em history
9b50d902SRodney W. Grimesmechanism).
9b50d902SRodney W. Grimes.Sh HISTORY
9b50d902SRodney W. GrimesThe
9b50d902SRodney W. Grimes.Nm script
9b50d902SRodney W. Grimescommand appeared in
9b50d902SRodney W. Grimes.Bx 3.0 .
9b50d902SRodney W. Grimes.Sh BUGS
9b50d902SRodney W. Grimes.Nm Script
9b50d902SRodney W. Grimesplaces
9b50d902SRodney W. Grimes.Sy everything
9b50d902SRodney W. Grimesin the log file, including linefeeds and backspaces.
9b50d902SRodney W. GrimesThis is not what the naive user expects.