[unix-history] / usr / man / man1 / script.1

.TH SCRIPT 1
.UC 4
.SH NAME
script \- make typescript of terminal session
.SH SYNOPSIS
.B script
[
.B \-a
] [
.B \-q
] [
.B \-S
shell
] [ file ]
.SH DESCRIPTION
.I Script
makes a typescript of everything printed on your terminal.
The typescript is saved in a file, and can be sent to the
line printer later with
.I lpr.
If a file name is given, the typescript
is saved there.  If not, the typescript is saved in the file
.I typescript.
.PP
To exit script, type control D.  This sends an end of file to
all processes you have started up, and causes script to exit.
For this reason, control D behaves as though you had typed an
infinite number of control D's.
.PP
This program is useful when using a crt and a hard-copy
record of the dialog is desired, as for a student handing
in a program that was developed on a crt when hard-copy
terminals are in short supply.
.PP
.B \-S
lets you specify the shell to use.
The default depends on the system:
If the variable SHELL is set in the environment, it is used if possible.
.PP
The
.B \-q
flag asks for ``quiet mode'', where the ``script started''
and ``script done'' messages are turned off.
The
.B \-a
flag causes script to append to the typescript file
instead of creating a new file.
.SH AUTHOR
Mark Horton
.SH BUGS
Since UNIX has no way to write an end-of-file down a pipe without closing
the pipe, there is no way to simulate a single control D without
ending script.
.PP
The new shell has its standard input coming
from a pipe rather than a tty, so stty will not work, and neither
will ttyname.
In particular, this means that screen editors such as
.IR vi (1)
and the job control facilities of
.IR csh (1)
are inoperative.
.PP
When the user interrupts a printing process,
.I script
attempts to flush the output backed up in the pipe for better response.
Usually the next prompt also gets flushed.
Commit	Line	Data
e3758c96 C	1	.TH SCRIPT 1
	2	.UC 4
	3	.SH NAME
	4	script \- make typescript of terminal session
	5	.SH SYNOPSIS
	6	.B script
	7	[
	8	.B \-a
	9	] [
	10	.B \-q
	11	] [
	12	.B \-S
	13	shell
	14	] [ file ]
	15	.SH DESCRIPTION
	16	.I Script
	17	makes a typescript of everything printed on your terminal.
	18	The typescript is saved in a file, and can be sent to the
	19	line printer later with
	20	.I lpr.
	21	If a file name is given, the typescript
	22	is saved there. If not, the typescript is saved in the file
	23	.I typescript.
	24	.PP
	25	To exit script, type control D. This sends an end of file to
	26	all processes you have started up, and causes script to exit.
	27	For this reason, control D behaves as though you had typed an
	28	infinite number of control D's.
	29	.PP
	30	This program is useful when using a crt and a hard-copy
	31	record of the dialog is desired, as for a student handing
	32	in a program that was developed on a crt when hard-copy
	33	terminals are in short supply.
	34	.PP
	35	.B \-S
	36	lets you specify the shell to use.
	37	The default depends on the system:
	38	If the variable SHELL is set in the environment, it is used if possible.
	39	.PP
	40	The
	41	.B \-q
	42	flag asks for ``quiet mode'', where the ``script started''
	43	and ``script done'' messages are turned off.
	44	The
	45	.B \-a
	46	flag causes script to append to the typescript file
	47	instead of creating a new file.
	48	.SH AUTHOR
	49	Mark Horton
	50	.SH BUGS
	51	Since UNIX has no way to write an end-of-file down a pipe without closing
	52	the pipe, there is no way to simulate a single control D without
	53	ending script.
	54	.PP
	55	The new shell has its standard input coming
	56	from a pipe rather than a tty, so stty will not work, and neither
	57	will ttyname.
	58	In particular, this means that screen editors such as
	59	.IR vi (1)
	60	and the job control facilities of
	61	.IR csh (1)
	62	are inoperative.
	63	.PP
	64	When the user interrupts a printing process,
65	.I script
66	attempts to flush the output backed up in the pipe for better response.
67	Usually the next prompt also gets flushed.