Changeset View
Changeset View
Standalone View
Standalone View
usr.bin/script/script.1
Show All 22 Lines | |||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" @(#)script.1 8.1 (Berkeley) 6/6/93 | .\" @(#)script.1 8.1 (Berkeley) 6/6/93 | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd January 5, 2021 | .Dd March 9, 2022 | ||||
.Dt SCRIPT 1 | .Dt SCRIPT 1 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm script | .Nm script | ||||
.Nd make typescript of terminal session | .Nd make typescript of terminal session | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.Op Fl aefkqr | .Op Fl aefkqr | ||||
.Op Fl F Ar pipe | .Op Fl F Ar pipe | ||||
.Op Fl t Ar time | .Op Fl t Ar time | ||||
allanjude: This should go in the 2nd section of the synopsis with -p shouldn't it? You don't use -T while… | |||||
.Op Ar file Op Ar command ... | .Op Ar file Op Ar command ... | ||||
.Nm | .Nm | ||||
.Fl p | .Fl p | ||||
.Op Fl deq | .Op Fl deq | ||||
.Op Fl T Ar fmt | |||||
Done Inline ActionsThis is where -T would go I think, since it implies -p anyway allanjude: This is where -T would go I think, since it implies -p anyway | |||||
.Op Ar file | .Op Ar file | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
The | The | ||||
.Nm | .Nm | ||||
utility makes a typescript of everything printed on your terminal. | utility makes a typescript of everything printed on your terminal. | ||||
It is useful for students who need a hardcopy record of an interactive | It is useful for students who need a hardcopy record of an interactive | ||||
session as proof of an assignment, as the typescript file | session as proof of an assignment, as the typescript file | ||||
can be printed out later with | can be printed out later with | ||||
▲ Show 20 Lines • Show All 60 Lines • ▼ Show 20 Lines | |||||
Specify the interval at which the script output file will be flushed | Specify the interval at which the script output file will be flushed | ||||
to disk, in seconds. | to disk, in seconds. | ||||
A value of 0 | A value of 0 | ||||
causes | causes | ||||
.Nm | .Nm | ||||
to flush after every character I/O event. | to flush after every character I/O event. | ||||
The default interval is | The default interval is | ||||
30 seconds. | 30 seconds. | ||||
.It Fl T Ar fmt | |||||
Implies | |||||
.Fl p , | |||||
but just reports the time-stamp of each output. | |||||
This is very useful for assessing the timing of events. | |||||
.Pp | |||||
If | |||||
.Ar fmt | |||||
does not contain any | |||||
.Ql % | |||||
characters, it indicates the default format: | |||||
.Ql %n@ %s [%Y-%m-%d %T]\ , | |||||
which is useful for both tools and humans to read, should be used. | |||||
.El | .El | ||||
.Pp | .Pp | ||||
The script ends when the forked shell (or command) exits (a | The script ends when the forked shell (or command) exits (a | ||||
.Em control-D | .Em control-D | ||||
to exit | to exit | ||||
the Bourne shell | the Bourne shell | ||||
.Pf ( Xr sh 1 ) , | .Pf ( Xr sh 1 ) , | ||||
and | and | ||||
▲ Show 20 Lines • Show All 160 Lines • Show Last 20 Lines |
This should go in the 2nd section of the synopsis with -p shouldn't it? You don't use -T while recording, only while playing back