ng_cisco.4 (f8307e1233657707bc582110f07373c96d91943b) ng_cisco.4 (5129159789cc9d7bc514e4546b88e3427695002d)
1.\" Copyright (c) 1996-1999 Whistle Communications, Inc.
2.\" All rights reserved.
3.\"
4.\" Subject to the following obligations and disclaimer of warranty, use and
5.\" redistribution of this software, in source or object code forms, with or
6.\" without modifications are expressly permitted by Whistle Communications;
7.\" provided, however, that:
8.\" 1. Any and all reproductions of the source or object code must include the

--- 23 unchanged lines hidden (view full) ---

32.\"
33.\" Author: Archie Cobbs <archie@whistle.com>
34.\"
35.\" $FreeBSD$
36.\" $Whistle: ng_cisco.8,v 1.5 1999/01/25 23:46:26 archie Exp $
37.\"
38.Dd January 19, 1999
39.Dt NG_CISCO 8
1.\" Copyright (c) 1996-1999 Whistle Communications, Inc.
2.\" All rights reserved.
3.\"
4.\" Subject to the following obligations and disclaimer of warranty, use and
5.\" redistribution of this software, in source or object code forms, with or
6.\" without modifications are expressly permitted by Whistle Communications;
7.\" provided, however, that:
8.\" 1. Any and all reproductions of the source or object code must include the

--- 23 unchanged lines hidden (view full) ---

32.\"
33.\" Author: Archie Cobbs <archie@whistle.com>
34.\"
35.\" $FreeBSD$
36.\" $Whistle: ng_cisco.8,v 1.5 1999/01/25 23:46:26 archie Exp $
37.\"
38.Dd January 19, 1999
39.Dt NG_CISCO 8
40.Os FreeBSD 3
40.Os FreeBSD
41.Sh NAME
42.Nm ng_cisco
43.Nd Cisco HDLC protocol netgraph node type
44.Sh SYNOPSIS
45.Fd #include <netinet/in.h>
46.Fd #include <netgraph/ng_cisco.h>
47.Sh DESCRIPTION
48The
49.Nm cisco
50node type performs encapsulation and de-encapsulation of packets
51using the Cisco HDLC protocol. This is a fairly simple
52protocol for the transmission of packets across
53high speed synchronous lines. Each packet is prepended with
54an Ethertype, indicating the protocol. There is also a
41.Sh NAME
42.Nm ng_cisco
43.Nd Cisco HDLC protocol netgraph node type
44.Sh SYNOPSIS
45.Fd #include <netinet/in.h>
46.Fd #include <netgraph/ng_cisco.h>
47.Sh DESCRIPTION
48The
49.Nm cisco
50node type performs encapsulation and de-encapsulation of packets
51using the Cisco HDLC protocol. This is a fairly simple
52protocol for the transmission of packets across
53high speed synchronous lines. Each packet is prepended with
54an Ethertype, indicating the protocol. There is also a
55``keep alive'' and an ``inquire'' capability.
55.Dq keep alive
56and an
57.Dq inquire
58capability.
56.Pp
57The
58.Dv downstream
59hook should connect to the synchronous line. On the other side
60of the node are the
61.Dv inet ,
62.Dv atalk ,
63and
64.Dv ipx
65hooks, which transmit and receive raw IP, AppleTalk, and IPX packets,
66respectively. Typically these hooks would connect to the corresponding
67hooks on an
68.Xr ng_iface 8
69type node.
70.Sh IP Configuration
71In order to function properly for IP traffic, the node must be informed
72of the local IP address and netmask setting. This is because the protocol
59.Pp
60The
61.Dv downstream
62hook should connect to the synchronous line. On the other side
63of the node are the
64.Dv inet ,
65.Dv atalk ,
66and
67.Dv ipx
68hooks, which transmit and receive raw IP, AppleTalk, and IPX packets,
69respectively. Typically these hooks would connect to the corresponding
70hooks on an
71.Xr ng_iface 8
72type node.
73.Sh IP Configuration
74In order to function properly for IP traffic, the node must be informed
75of the local IP address and netmask setting. This is because the protocol
73includes an ``inquire'' packet which we must be prepared to answer.
76includes an
77.Dq inquire
78packet which we must be prepared to answer.
74There are two ways to accomplish this, manually and automatically.
75.Pp
76Whenever such an inquire packet is received, the node sends a
77.Dv NGM_CISCO_GET_IPADDR
78control message to the peer node connected to the
79.Dv inet
80hook (if any).
81If the peer responds, then that response is used. This is the automatic method.

--- 67 unchanged lines hidden (view full) ---

149.Xr ng_iface 8 ,
150.Xr ngctl 8 .
151.Rs
152.%A D. Perkins
153.%T "Requirements for an Internet Standard Point-to-Point Protocol"
154.%O RFC 1547
155.Re
156.Sh LEGAL
79There are two ways to accomplish this, manually and automatically.
80.Pp
81Whenever such an inquire packet is received, the node sends a
82.Dv NGM_CISCO_GET_IPADDR
83control message to the peer node connected to the
84.Dv inet
85hook (if any).
86If the peer responds, then that response is used. This is the automatic method.

--- 67 unchanged lines hidden (view full) ---

154.Xr ng_iface 8 ,
155.Xr ngctl 8 .
156.Rs
157.%A D. Perkins
158.%T "Requirements for an Internet Standard Point-to-Point Protocol"
159.%O RFC 1547
160.Re
161.Sh LEGAL
157Cisco is a trademark of Cisco Systems, Inc.
162.Tn Cisco
163is a trademark of Cisco Systems, Inc.
164.Sh HISTORY
165The
166.Nm
167node type was implemented in
168.Fx 4.0 .
158.Sh AUTHORS
169.Sh AUTHORS
159Julian Elischer <julian@whistle.com>,
160Archie Cobbs <archie@whistle.com>
170.An Julian Elischer Aq julian@whistle.com ,
171.An Archie Cobbs Aq archie@whistle.com