4.4BSD/usr/share/man/cat1/script.0

SCRIPT(1)                    BSD Reference Manual                    SCRIPT(1)

NNAAMMEE
     ssccrriipptt - make typescript of terminal session

SSYYNNOOPPSSIISS
     ssccrriipptt [--aa] [_f_i_l_e]

DDEESSCCRRIIPPTTIIOONN
     SSccrriipptt 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 lat-
     er with lpr(1).

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

     Option:

     --aa      Append the output to _f_i_l_e or _t_y_p_e_s_c_r_i_p_t, retaining the prior con-
             tents.

     The script ends when the forked shell exits (a _c_o_n_t_r_o_l_-_D to exit the
     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
     set) for the C-shell, csh(1)).

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

EENNVVIIRROONNMMEENNTT
     The following environment variable is utilized by ssccrriipptt:

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

SSEEEE AALLSSOO
     csh(1) (for the _h_i_s_t_o_r_y mechanism).

HHIISSTTOORRYY
     The ssccrriipptt command appeared in 3.0BSD.

BBUUGGSS
     SSccrriipptt places eevveerryytthhiinngg in the log file, including linefeeds and
     backspaces.  This is not what the naive user expects.

4th Berkeley Distribution        June 6, 1993                                1