.TH psh_ipv6 3 "97/02/01"
.SH SYNOPSIS
.sp
\fBipv6.h2a \fIhostname\fR
.sp
\fBipv6.a2h \fIaddress\fR
.sp
\fBipv6.{src|dst} \fIhostname|address\fR
.sp
\fBipv6.a2ndm \fIaddress\fR
.sp
\fBpopen ipv6 \fIid interface ether-src ether-dst \fR[\fIfilter\fR]
.sp
\fBpclose ipv6 \fIid\fR
.sp
\fBpinit ipv6 \fIpkt\fP \fR[\fImaxlength \fR[\fIlength\fR]]
.sp
\fBpfree \fIpkt\fR
.sp
\fBpget ipv6 \fIpkt field-name\fR
.sp
\fBpset ipv6 \fIpkt field-name> value\fR
.sp
\fBplist \fIpkt ipv6\fR
.sp
\fIid\fB.send \fIpkt\fR
.sp
\fIid\fB.recv \fIpkt \fR[\fItimeout\fR]
.sp
.SH DESCRIPTION
.sp
.PP
.TP 2
\fBipv6.h2a \fIhostname\fP\fR
Convert the hostname <hostname> to an IPv6 address.
.TP 2
\fBipv6.a2h \fIaddress\fP\fR
Convert the given IPv6 address <address> to a hostname.
.TP 2
\fBipv6.src \fIhostname|address\fP\fR
Set the default source address to be used when packets are pinit'ed.
.TP 2
\fBipv6.dst \fIhostname|address\fP\fR
Set the default destination address to be used when packets are
pinit'ed.
.TP 2
\fBipv6.a2ndm \fIhostname\fP\fR
Convert a given host address into the corresponding neighbor
discovery multicast address.
.TP 2
\fBpopen ipv6 \fIid interface ether-src ether-dst \fR[\fIfilter\fR]
Open the indicated interface, and attach it to the IPv6 end-point name
indicated.  Also specify the initial ethernet source address \fIether-src\fP
and destination address \fIether-dst\fP.
.TP 2
\fBpclose ipv6 \fIid\fP\fR
Close a previously popen'ed ipv6 end-point.
.TP 2
\fBpinit ipv6 \fIpkt\fP \fR[\fImaxlength \fR[\fIlength\fR]]
Initialize a IPv6 packet variable.  The source and destination
addresses are initialized at creation to the default values.  Those
values must be set with \fBipv6.src\fP and \fBipv6.dst\fP commands.
For more information onthe \fImaxlength\fR and \fIlength\fP parameters,
see the \fRpsh\fP(1) manual page.
.TP 2
\fBpfree \fIpkt\fR
Free the indicated packet buffer named \fIpkt\fP.
.TP 2
\fBpget \fIpkt\fP ipv6 \fIfield-name\fR
Fetch the indicated field \fIfield-name\fP from the indicated packet
\fIpkt\fP.  The valid fields are the following: dst, src, proto, len
v, flow, and ttl.
.sp
Refer to RFC1883 for an explanation of the fields.
.TP 2
\fBpset \fIpkt\fP ipv6 \fIfield-name\fR
Set the indicated field \fIfield-name\fP from the indicated packet
\fIpkt\fP to the value \fIvalue\fP.  Similar to the above.
.TP 2
\fBplist \fIpkt\fP ipv6\fR
Summarize a ipv6 packet.
.TP 2
\fB\fIid\fP.send \fIpkt\fP\fR
Send the ipv6 packet indicated.
.TP 2
\fB\fIid\fP.recv \fIpkt\fP \fR[\fItimeout\fR]
Receive a packet \fIpkt\fP through the indicated end-point name
\fIid\fP.  If the \fItimeout\fP parameter is present, it will wait 
only \fItimeout\fP milliseconds for a packet to be received.  This
command returns either the string "packet" if a packet was
received, or "timeout" if a timeout occurred before a packet
was received.
.sp
.SH FILES
.TP 25
\f3/opt/psh/lib/\f2\ipv6\f0
Dynamically linked library protocol for IPv6.
.SH "SEE ALSO"
.BR xpsh (1),
.BR psh (1),
.BR protolib (3). 

