| script.1 (79755) | script.1 (95124) |
|---|---|
| 1.\" Copyright (c) 1980, 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)script.1 8.1 (Berkeley) 6/6/93 | 1.\" Copyright (c) 1980, 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)script.1 8.1 (Berkeley) 6/6/93 |
| 33.\" $FreeBSD: head/usr.bin/script/script.1 79755 2001-07-15 08:06:20Z dd $ | 33.\" $FreeBSD: head/usr.bin/script/script.1 95124 2002-04-20 12:18:28Z charnier $ |
| 34.\" 35.Dd June 6, 1993 36.Dt SCRIPT 1 37.Os 38.Sh NAME 39.Nm script 40.Nd make typescript of terminal session 41.Sh SYNOPSIS 42.Nm 43.Op Fl a 44.Op Fl k 45.Op Fl q 46.Op Fl t Ar time 47.Op Ar file Op command ... 48.Sh DESCRIPTION | 34.\" 35.Dd June 6, 1993 36.Dt SCRIPT 1 37.Os 38.Sh NAME 39.Nm script 40.Nd make typescript of terminal session 41.Sh SYNOPSIS 42.Nm 43.Op Fl a 44.Op Fl k 45.Op Fl q 46.Op Fl t Ar time 47.Op Ar file Op command ... 48.Sh DESCRIPTION |
| 49.Nm Script 50makes a typescript of everything printed on your terminal. | 49The 50.Nm 51utility makes a typescript of everything printed on your terminal. |
| 51It is useful for students who need a hardcopy record of an interactive 52session as proof of an assignment, as the typescript file 53can be printed out later with 54.Xr lpr 1 . 55.Pp 56If the argument 57.Ar file 58is given, --- 44 unchanged lines hidden (view full) --- 103.Em ignoreeof 104is not set) for the 105C-shell, 106.Xr csh 1 ) . 107.Pp 108Certain interactive commands, such as 109.Xr vi 1 , 110create garbage in the typescript file. | 52It is useful for students who need a hardcopy record of an interactive 53session as proof of an assignment, as the typescript file 54can be printed out later with 55.Xr lpr 1 . 56.Pp 57If the argument 58.Ar file 59is given, --- 44 unchanged lines hidden (view full) --- 104.Em ignoreeof 105is not set) for the 106C-shell, 107.Xr csh 1 ) . 108.Pp 109Certain interactive commands, such as 110.Xr vi 1 , 111create garbage in the typescript file. |
| 111.Nm Script 112works best with commands that do not manipulate the screen. | 112The 113.Nm 114utility works best with commands that do not manipulate the screen. |
| 113The results are meant to emulate a hardcopy terminal, not an addressable one. 114.Sh ENVIRONMENT 115The following environment variable is utilized by 116.Nm : 117.Bl -tag -width SHELL 118.It Ev SHELL 119If the variable 120.Ev SHELL --- 12 unchanged lines hidden (view full) --- 133.Em history 134mechanism). 135.Sh HISTORY 136The 137.Nm 138command appeared in 139.Bx 3.0 . 140.Sh BUGS | 115The results are meant to emulate a hardcopy terminal, not an addressable one. 116.Sh ENVIRONMENT 117The following environment variable is utilized by 118.Nm : 119.Bl -tag -width SHELL 120.It Ev SHELL 121If the variable 122.Ev SHELL --- 12 unchanged lines hidden (view full) --- 135.Em history 136mechanism). 137.Sh HISTORY 138The 139.Nm 140command appeared in 141.Bx 3.0 . 142.Sh BUGS |
| 141.Nm Script 142places | 143The 144.Nm 145utility places |
| 143.Sy everything 144in the log file, including linefeeds and backspaces. 145This is not what the naive user expects. 146.Pp 147It is not possible to specify a command without also naming the script file 148because of argument parsing compatibility issues. 149.Pp 150When running in 151.Fl k 152mode, echo cancelling is far from ideal. The slave terminal mode is checked 153for ECHO mode to check when to avoid manual echo logging. This does not 154work when in a raw mode where the program being run is doing manual echo. | 146.Sy everything 147in the log file, including linefeeds and backspaces. 148This is not what the naive user expects. 149.Pp 150It is not possible to specify a command without also naming the script file 151because of argument parsing compatibility issues. 152.Pp 153When running in 154.Fl k 155mode, echo cancelling is far from ideal. The slave terminal mode is checked 156for ECHO mode to check when to avoid manual echo logging. This does not 157work when in a raw mode where the program being run is doing manual echo. |