161599Sbostic.\" Copyright (c) 1985, 1991, 1993 261599Sbostic.\" The Regents of the University of California. All rights reserved. 324106Ssklower.\" 443581Strent.\" %sccs.include.redist.man% 524106Ssklower.\" 6*64994Smckusick.\" @(#)nsip.4 8.2 (Berkeley) 11/30/93 736752Sbostic.\" 847675Scael.Dd 947675Scael.Dt NSIP 4 1047675Scael.Os BSD 4.3 1147675Scael.Sh NAME 1247675Scael.Nm nsip 1347675Scael.Nd software network interface encapsulating NS packets in IP packets 1447675Scael.Sh SYNOPSIS 1547675Scael.Cd options NSIP 1647675Scael.Fd #include <netns/ns_if.h> 1747675Scael.Sh DESCRIPTION 1824106SsklowerThe 1947675Scael.Nm nsip 2024106Ssklowerinterface is a software mechanism which may be 2147675Scaelused to transmit Xerox 2247675Scael.Tn NS Ns (tm) 2347675Scaelpackets through otherwise uncooperative 2424106Ssklowernetworks. 2547675ScaelIt functions by prepending an 2647675Scael.Tn IP 2747675Scaelheader, and resubmitting the packet 2847675Scaelthrough the 2947675Scael.Tn UNIX 3047675Scael.Tn IP 3147675Scaelmachinery. 3247675Scael.Pp 3324106SsklowerThe super-user can advise the operating system of a willing partner 3447675Scaelby naming an 3547675Scael.Tn IP 3647675Scaeladdress to be associated with an 3747675Scael.Tn NS 3847675Scaeladdress. 3924106SsklowerPresently, only specific hosts pairs are allowed, and for each host 4024106Ssklowerpair, an artificial point-to-point interface is constructed. 4147675ScaelAt some future date, 4247675Scael.Tn IP 4347675Scaelbroadcast addresses or hosts may be paired 4447675Scaelwith 4547675Scael.Tn NS 4647675Scaelnetworks or hosts. 4747675Scael.Pp 4847675ScaelSpecifically, a socket option of 4947675Scael.Dv SO_NSIP_ROUTE 5047675Scaelis set on a socket 5147675Scaelof family 5247675Scael.Dv AF_NS , 5347675Scaeltype 5447675Scael.Dv SOCK_DGRAM , 5547675Scaelpassing the following structure: 5647675Scael.Bd -literal 5724106Ssklowerstruct nsip_req { 5824106Ssklower struct sockaddr rq_ns; /* must be ns format destination */ 5924106Ssklower struct sockaddr rq_ip; /* must be ip format gateway */ 6024106Ssklower short rq_flags; 6124106Ssklower}; 6247675Scael.Ed 6347675Scael.Sh DIAGNOSTICS 6447675Scael.Bl -diag 6547675Scael.It nsip%d: can't handle af%d. 6647675ScaelThe interface was handed 6724106Ssklowera message with addresses formatted in an unsuitable address 6824106Ssklowerfamily; the packet was dropped. 6947675Scael.El 7047675Scael.Sh SEE ALSO 7147675Scael.Xr intro 4 , 7247675Scael.Xr ns 4 7347675Scael.Sh HISTORY 7447675ScaelThe 7547675Scael.Nm 7647675Scaelinterface appeared in 7747675Scael.Bx 4.3 . 7847675Scael.Sh BUGS 7924106SsklowerIt is absurd to have a separate pseudo-device for each pt-to-pt 8024106Ssklowerlink. 8147675ScaelThere is no way to change the 8247675Scael.Tn IP 8347675Scaeladdress for an 8447675Scael.Tn NS 8547675Scaelhost once the 86*64994Smckusickencapsulation interface is set up. 8747675ScaelThe request should honor flags of 8847675Scael.Dv RTF_GATEWAY 8947675Scaelto indicate 9047675Scaelremote networks, and the absence of 9147675Scael.Dv RTF_UP 9247675Scaelshould be a clue 9324106Ssklowerto remove that partner. 9447675ScaelThis was intended to postpone the necessity of rewriting reverse 9547675Scael.Tn ARP 9624106Ssklowerfor the 9747675Scael.Xr en 4 9847675Scaeldevice, and to allow passing 9947675Scael.Tn XNS 10047675Scaelpackets through an 10124106SsklowerArpanet-Milnet gateway, to facilitate testing between some co-operating 10224106Sskloweruniversities. 103