NAME    [Toc]    [Back]

     script - make typescript of terminal session

SYNOPSIS    [Toc]    [Back]

     script [-a] [file]

DESCRIPTION    [Toc]    [Back]

     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.

     The options are as follows:

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


     The script ends when the forked  shell  exits  (a  control-D
(`^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)).  script  will  exit  with
the status of 0
     unless  any  of  its  child  processes  fail. In which case,
script will return
     1.

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

ENVIRONMENT    [Toc]    [Back]

     SHELL   Name  of  the  shell to be forked by script.  If not
set, the Bourne
            shell is assumed.  (Most shells set this variable automatically.)

SEE ALSO    [Toc]    [Back]

     csh(1) (for the history mechanism)

HISTORY    [Toc]    [Back]

     The script command appeared in 3.0BSD.

BUGS    [Toc]    [Back]

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

OpenBSD      3.6                           June      6,      1993