xref: /386bsd/usr/share/man/cat1/script.0 (revision a2142627)
1SCRIPT(1)                   386BSD Reference Manual                  SCRIPT(1)
2
3NNAAMMEE
4     ssccrriipptt - make typescript of terminal session
5
6SSYYNNOOPPSSIISS
7     ssccrriipptt [--aa] [_f_i_l_e]
8
9DDEESSCCRRIIPPTTIIOONN
10     SSccrriipptt makes a typescript of everything printed on your terminal.  It is
11     useful for students who need a hardcopy record of an interactive session
12     as proof of an assignment, as the typescript file can be printed out
13     later with lpr(1).
14
15     If the argument _f_i_l_e is given, ssccrriipptt saves all dialogue in _f_i_l_e. If no
16     file name is given, the typescript is saved in the file _t_y_p_e_s_c_r_i_p_t.
17
18     Option:
19
20     --aa      Append the output to _f_i_l_e or _t_y_p_e_s_c_r_i_p_t, retaining the prior
21             contents.
22
23     The script ends when the forked shell exits (a _c_o_n_t_r_o_l-_D to exit the
24     Bourne shell (sh(1)),  and _e_x_i_t, _l_o_g_o_u_t or _c_o_n_t_r_o_l-_d (if _i_g_n_o_r_e_e_o_f is not
25     set) for the C-shell, csh(1)).
26
27     Certain interactive commands, such as vi(1),  create garbage in the
28     typescript file.  SSccrriipptt works best with commands that do not manipulate
29     the screen, the results are meant to emulate a hardcopy terminal.
30
31EENNVVIIRROONNMMEENNTT
32     The following environment variable is utilized by ssccrriipptt:
33
34     SHELL  If the variable SHELL exists, the shell forked by ssccrriipptt will be
35            that shell. If SHELL is not set, the Bourne shell is assumed.
36            (Most shells set this variable automatically).
37
38SSEEEE AALLSSOO
39     csh(1) (for the _h_i_s_t_o_r_y mechanism).
40
41HHIISSTTOORRYY
42     The ssccrriipptt command appeared in 3.0BSD.
43
44BBUUGGSS
45     SSccrriipptt places eevveerryytthhiinngg in the log file, including linefeeds and
46     backspaces.  This is not what the naive user expects.
47
484th Berkeley Distribution        July 27, 1991                               1
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67