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

FreeBSD Manual Pages


home | help
SCRIPT(1)		  BSD General Commands Manual		     SCRIPT(1)

     script -- make typescript of terminal session

     script [-a] [-k] [-q] [-t time] [file] [command ...]

     Script makes a typescript of everything printed on	your terminal.	It is
     useful for	students who need a hardcopy record of an interactive session
     as	proof of an assignment,	as the typescript file can be printed out
     later with	lpr(1).

     If	the argument file is given, script saves all dialogue in file.	If no
     file name is given, the typescript	is saved in the	file typescript.

     If	the argument command ... is given, script will run the specified com-
     mand with an optional argument vector instead of an interactive shell.


     -a	      Append the output	to file	or typescript, retaining the prior

     -k	      Log keys sent to program as well as output.

     -q	      Run in quiet mode, omit the start	and stop status	messages.

     -t	time  Specify time interval between flushing script output file.  A
	      value of 0 causes	script to flush	for every character I/O	event.

     The script	ends when the forked shell (or command)	exits (a control-D to
     exit the Bourne shell (sh(1)), and	exit, logout or	control-d (if
     ignoreeof is not set) for the C-shell, csh(1)).

     Certain interactive commands, such	as vi(1), create garbage in the	type-
     script file.  Script works	best with commands that	do not manipulate the
     screen, the results are meant to emulate a	hardcopy terminal.

     The following environment variable	is utilized by script:

     SHELL  If the variable SHELL exists, the shell forked by script will be
	    that shell.	If SHELL is not	set, the Bourne	shell is assumed.
	    (Most shells set this variable automatically).

     csh(1) (for the history mechanism).

     The script	command	appeared in 3.0BSD.

     Script places everything in the log file, including linefeeds and
     backspaces.  This is not what the naive user expects.

     It	is not possible	to specify a command without also naming the script
     file because of argument parsing compatibility issues.

     When running in -k	mode, echo cancelling far from ideal.  The slave ter-
     minal mode	is checked for ECHO mode to check when to avoid	manual echo
     logging.  This does not work when in a raw	mode where the program being
     run is doing manual echo.

4th Berkeley Distribution	 June 6, 1993	     4th Berkeley Distribution


Want to link to this manual page? Use this URL:

home | help