SysIII/usr/src/man/man1/vpmstart.1c

.TH VPMSTART 1C
.SH NAME
vpmstart, vpmsnap, vpmtrace \- load the \s-1KMC\s+111-B; print \s-1VPM\s+1 traces
.SH SYNOPSIS
.B vpmstart
device n [ filen ]
.PP
.B vpmsnap
.PP
.B vpmtrace
.SH DESCRIPTION
.I Vpmstart\^
writes
.I filen\^
.RB ( a.out
by default) to the
.SM KMC\*S11-B
specified by
.IR device .
.PP
The argument
.I n\^
is a magic number that the
.SM KMC\*S11-B
driver
saves to identify the running program.
This number is checked when the
.SM VPM
driver is opened
to provide some assurance that the program running in the
.SM KMC\*S11-B
is the one expected.
The magic number for
.SM VPM
interpreters is 6.
When
.I filen\^
has been written to the
.SM KMC\*S11-B,
its execution is begun.
.I Filen\^
may be any file executable by the
.SM KMC\*S11-B.
.PP
If
.I filen\^
is made using
.IR vpmc (1C),
the
.SM VPM
interpreter will be started by
.IR vpmstart .
The
.SM VPM
interpreter waits for a
.SM RUN
command
from the
.SM VPM
driver before beginning execution
of the protocol script.
The
.SM RUN
command is sent by the
.SM VPM
driver when the corresponding
.SM VPM
device file is opened.
.PP
.I Vpmsnap\^
opens the trace driver (minor device number 1)
and reads and prints time-stamped event records until killed.
.PP
.I Vpmtrace\^
opens the trace driver (minor device number 0) and
reads and prints event records until killed.
.SH SEE ALSO
vpmc(1C), trace(4), vpm(4).