Network Working Group                                           M. Allen
Request for Comments: 1362                                  Novell, Inc.
                                                         September 1992


              Novell IPX Over Various WAN Media (IPXWAN)

Status of this Memo

  This memo provides information for the Internet community.  It does
  not specify an Internet standard.  Distribution of this memo is
  unlimited.

Abstract

  This document describes how Novell IPX operates over various WAN
  media.  Specifically, it describes the common "IPX WAN" protocol
  Novell uses to exchange necessary router to router information prior
  to exchanging standard IPX routing information and traffic over WAN
  datalinks.

Table of Contents

  1.  Introduction .................................................  1
  1.1. Operation Over PPP ..........................................  2
  1.2. Operation Over X.25 Switched Virtual Circuits ...............  2
  1.3. Operation Over X.25 Permanent Virtual Circuits ..............  2
  1.4. Operation Over Frame Relay ..................................  3
  1.5. Operation Over Other WAN Media ..............................  3
  2.  Glossary Of Terms ............................................  3
  3.  IPX WAN Protocol Description .................................  4
  4.  Information Exchange Packet Formats ..........................  5
  4.1. Timer Request Packet ........................................  6
  4.2. Timer Response Packet .......................................  8
  4.3. Information Request Packet .................................. 10
  4.4. Information Response Packet ................................. 12
  5.  References ................................................... 12
  6.  Security Considerations ...................................... 13
  7.  Author's Address.............................................. 13

1. Introduction

  This document describes how Novell IPX operates over various WAN
  media. It is strongly motivated by a desire for IPX to treat ALL wide
  area links in the same manner. Sections 3 and 4 describe this common
  "IPX WAN" protocol.





Allen                                                           [Page 1]

RFC 1362                         IPXWAN                   September 1992


  IPX WAN protocol operation begins immediately after link
  establishment. While IPX is a connectionless datagram protocol, WANs
  are often connection-oriented.  Different WANs have different methods
  of link establishment. The subsections of section 1 of this document
  describe what link establishment means to IPX for different media.
  They also describe other WAN-media-dependent aspects of IPX
  operation, such as protocol identification, frame encapsulation, and
  link tear down.

1.1 Operation Over PPP

  IPX uses PPP [1] when operating over point-to-point synchronous and
  asynchronous networks.

  With PPP, link establishment means the IPX NCP [4] reaches the Open
  state. NetWare IPX will reject all NCP options, and uses normal frame
  encapsulation as defined by PPP. The IPXWAN protocol MUST NOT occur
  until the IPX NCP reaches the Open state.

  PPP allows either side of a connection to stop forwarding IPX if one
  end sends an IPXCP or an LCP Terminate-Request. When a router detects
  this, it will immediately reflect the lost connectivity in its
  routing information database instead of naturally aging it out.

1.2 Operation over X.25 Switched Virtual Circuits

  With X.25, link establishment means successfully opening an X.25
  virtual circuit.  As specified in RFC-1356, "Multiprotocol
  Interconnect on X.25 and ISDN in the Packet Mode" [2], the protocol
  identifier 0x800000008137 is used in the X.25 Call User Data field of
  the Call Request frame, and indicates that the virtual circuit will
  be devoted to IPX.

  Furthermore, each IPX packet is encapsulated directly in X.25 data
  frame sequences without additional framing.

  Either side of the virtual circuit may close it, thereby tearing down
  the IPX link. When a router detects this, it will immediately reflect
  the lost connectivity in its routing information database instead of
  naturally aging it out.

1.3 Operation over X.25 Permanent Virtual Circuits

  The nature of X.25 PVC's is that no call request is made.  When the
  router is informed that X.25 Layer 2 is up, the router should assume
  that link establishment is complete.





Allen                                                           [Page 2]

RFC 1362                         IPXWAN                   September 1992


  Each IPX packet is encapsulated in an X.25 data frame sequence
  without additional framing. Novell IPX assumes a particular X.25
  permanent circuit is devoted to the use of IPX.

  If a router receives a layer 2 error condition (e.g., X.25 Restart),
  it should reflect lost connectivity for the permanent circuits in its
  routing information database and re-perform the necessary steps to
  obtain a full IPX connection.

1.4 Operation over Frame Relay

  Novell conforms to RFC-1294, "Multiprotocol Interconnect over Frame
  Relay" [3] for frame relay service and packet encapsulation.
  Currently, Novell has not stabilized the method for treating frame
  relay connections - whether they treat the connections as LANs or
  WANs.

1.5 Operation over other WAN media

  Additional WAN media will be added here as specifications are
  developed.

2. Glossary Of Terms

Primary Network Number:

     Every IPX WAN router has a "primary network number". This is an
     IPX network number unique to the entire internet.  This number
     will be a permanently assigned network number for the router.
     Those readers familiar with NetWare 3.x servers should realize
     that this is the "Internal" network number.

Router Name:

     Every IPX WAN router must have a "Router Name". This is a symbolic
     name given to the router. Its purpose is to allow routers to know
     who they are connected to after link establishment - particularly
     for network management purposes.  A symbolic name conveys more
     information to an operator than a set of numbers. The symbolic
     name should be between 1 and 47 characters in length containing
     the characters 'A' through 'Z', underscore (_), hyphen (-) and
     "at" sign (@). The string of characters should be followed by a
     null character (byte of zero) and padded to 48 characters using
     the null character.  Those readers familiar with NetWare 3.x
     servers should realize that the file server name is the Router
     Name.





Allen                                                           [Page 3]

RFC 1362                         IPXWAN                   September 1992


3. IPX WAN Protocol Description

  IPX WAN links have the concept of a LINK MASTER and a LINK SLAVE.
  This relationship is decided upon based on information contained
  within the first IPX packets transferred across the WAN link.

  After link establishment, both sides of the link send "Timer Request"
  packets and start a timer waiting for a "Timer Response". These
  "Timer Request" packets are sent every 20 seconds until a response is
  received or a time-out occurs trying to initialize a connection (the
  timer is restarted each time a new "Timer Request" is sent). The
  time-out should be configurable, and is normally about one minute.
  This is directly dependent on the call setup time for the connection.
  If a time-out occurs, the router issues a disconnect on the offending
  connection and optionally attempts to retry the connection.

  When a "Timer Request" is received, the router with the lowest
  primary network number MUST respond with a "Timer Response" packet -
  and become the "Slave" of the link. If the "Slave" determines that it
  cannot support any of the Routing Types included in the "Timer
  Request" packet, the "Slave" should issue a disconnect on the
  connection being established. The "Master" of the link (determined
  when a "Timer Response" packet is received) is responsible for
  defining the network number that is to be used as a common network
  number for the new WAN link, and for calculating the RIP transport
  time that will be advertized to other RIP routers for the new link.
  This is calculated by stopping the timer which was started when a
  "Timer Request" was initiated and applying the algorithm in section
  4.2.

  To allow this, both sides of the link MUST have an adequate pool of
  WAN network numbers (unique within the internetwork) available to be
  assigned to the link when the call is fully completed. The "Master"
  of the link MUST then select a network number and construct an
  "Information Request" packet containing the calculated link delay,
  the common network number, and its own router name. On receiving this
  packet, the "Slave" MUST turn the packet around, overwrite the router
  name and node identifier and send an "Information Response".

  After the "Master" has received the "Information Response" and the
  "Slave" has received the "Information Request", standard IPX RIP and
  SAP packets are transferred across the WAN link, as currently defined
  for LAN links. The "IPX Router Specification" [5] contains
  information describing the Novell RIP/SAP protocol for third party
  developers.

  Note that the "Information Request" and "Information Response"
  packets are specific to the "Routing Type"=0 information exchanges.



Allen                                                           [Page 4]

RFC 1362                         IPXWAN                   September 1992


  With this routing type, no retransmission is made of any of the
  Information packets. If a response has not been received within the
  predefined time-out period, a disconnect is issued on the link, and
  the link can optionally be attempted later.

  If a router detects an error for which no suitable protocol response
  exists (e.g., unable to allocate a network number), the link should
  be terminated according to the relevant media specification.

  Under certain circumstances, particularly on X.25 permanent circuits,
  it is only possible to detect the remote router went away when it
  comes back up again.  In this case, one side of the link receives a
  Timer Request packet when IPX is in a fully connected state.  The
  side receiving the Timer Request MUST realize that a problem
  occurred, and revert to the IPX link establishment phase.
  Furthermore, the routing information learned from this connection
  should be immediately discarded.

4. Information Exchange Packet Formats

  All IPX WAN information exchange packets conform to the standard
  Novell IPX packet format. The packets use the IPX defined packet type
  04 defining a Packet Exchange Packet. The socket number 0x9004 is a
  Novell reserved socket number for exclusive use with IPX WAN
  information exchange. IPX defines that a network number of 0 is
  interpreted as being a local network of unknown number that requires
  no routing. This feature is of use to us in transferring these
  packets before the common network number is exchanged. Some routers
  need to know a "Node Number" (or MAC address) for each node on a
  link. Node numbers will be formed from the "WNode ID" field.  The
  node number will be the 4 bytes of WNode ID followed by 2 bytes of
  zero.

  Router Type number assignment. Other vendors IPX routing protocols
  can make use of the IPXWAN protocol definition by obtaining Router
  Types from Novell. This document will then include the new Router
  Types (with the references to vendor protocol description documents).

  WOption Number assignment. These numbers only need to be assigned
  from Novell for the "Timer Request" and "Timer Response" packets.
  Other packet types (e.g., the "Information Request" packets, are
  dependent on the "Router Type" negotiated and can contain any (vendor
  defined) packet type other than 0 or 1. WOption numbers in these
  packets are then defined by the vendor defining the Routing Type. The
  same packet format should still be maintained.






Allen                                                           [Page 5]

RFC 1362                         IPXWAN                   September 1992


4.1 Timer Request Packet

  +---------------------------------------------------------------+
  | Checksum         | FF FF             | Always FFFF            |
  | Packet Length    | 02 40             | Max IPX size (576 bytes|
  |                  |                   | Hi Lo order)           |
  | Trans Control    | 00                | Hops traversed         |
  | Packet Type      | 04                | Packet Exchange Packet |
  | Dest Net #       | 00 00 00 00       | Local Network          |
  | Dest Node #      | FF FF FF FF FF FF | Broadcast              |
  | Dest Socket #    | 90 04             | Reserved WAN socket    |
  | Source Net #     | 00 00 00 00       | Local Network          |
  | Source Node #    | 00 00 00 00 00 00 | Set to zero            |
  | Source Socket #  | 90 04             | Reserved WAN socket    |
  |------------------+-------------------+------------------------|
  | WIdentifier      | 57 41 53 4D       | Confidence identifier  |
  | WPacket Type     | 00                | Timer Request          |
  | WNode ID         | xx xx xx xx       | Primary Net # of       |
  |                  |                   | sending router         |
  |                  |                   | (Hi Lo order)          |
  | WSequence #      | xx                | Sequence start at 0    |
  | WNum Options     | 02                | 2 Options follow       |
  | WOption Number   | 00                | Define Routing Type    |
  | WAccept Option   | 01                | 0=No,1=Yes,3=Not Applic|
  | WOption Data Len | 00 01             | Option length (Hi Lo)  |
  | WOption Data     | 00                | IPX RIP/SAP Routing    |
  | WOption Number   | FF                | Pad option             |
  | WAccept Option   | 01                | 0=No,1=Yes,3=Not Applic|
  | WOption Data Len | 02 0E             | Pad data length (Hi Lo)|
  | WOption Data     | 00->FF's          | Repeated sequence of 00|
  |                  |                   | through FF's.          |
  +---------------------------------------------------------------+

  Note:
       Timer Request packets will always be 576 bytes. However,
       there should be no assumption made about the number of
       options specified in this packet.

  After link establishment, Timer Request packets are sent by both
  sides of the link. Each end starts their sequence number at zero.
  Subsequent retries (every 20 seconds) will increment the value of
  this sequence number.  Only a Timer Response packet with a sequence
  number matching the last sent sequence number will be acted upon.

  When receiving this packet, the WNode ID should be compared to the
  receiver's Primary Network #. If the WNode ID is larger than the
  receiver's Primary Network #, a Timer Response packet should be sent,
  and the receiver should become the link "Slave".



Allen                                                           [Page 6]

RFC 1362                         IPXWAN                   September 1992


  Packets received on the reserved socket number not having the
  WIdentifier set to the hexadecimal values noted above should be
  discarded.

Routing Type Option:

  A routing type of zero (0) is the minimum interoperability
  requirement (as defined by this document). A router ready to send a
  Timer Response (and receiving a routing type of zero) MUST respond
  with a routing type of zero. A router ready to send a Timer Response
  (and receiving routing types not matching a supported value) SHOULD
  respond with a Routing Type of zero indicating support for the
  minimum common protocol.

  Note that multiple Routing Type Options can be included in the Timer
  Request packet if the router supports multiple routing methods for
  IPX. The included Router Types MUST include and support this type
  zero option.

Accept Option (for Routing Type and PAD options):

  This field MUST be set to YES if the option is supported, and NO if
  an option is not supported. A Timer Response MUST respond with ONLY
  one Router Type set to YES.

PAD Option:

  This option will normally be the last entry in the packet.  Its sole
  purpose is to fill the IPX packet to be 576 bytes.  The pad option
  data will contain a repeating sequence of zero's through 0xFF's. This
  should stop compression modems from collapsing the packet and
  destroying the link delay calculation.

  Currently Assigned WOption Numbers (Timer Request Packet):
      Routing Type Option = 0x00;     Option Length = 0001
          Current option data values:
              0       Novell RIP/SAP routing with network
                      number assigned to the link.

      PAD Type Option     = 0xFF;     Option Length = Variable

      Compression Option  = 0x80;     Option Length = Variable
                        (length dependent on compression type)
          Current option data values:
              Byte 1  Compression type
                  0 = Telebit compression (length=3) [6]
                  Telebit Byte 2 - Compression options
                  Telebit Byte 3 - Number compression slots



Allen                                                           [Page 7]

RFC 1362                         IPXWAN                   September 1992


4.2. Timer Response Packet

  +---------------------------------------------------------------+
  | Checksum         | FF FF             | Always FFFF            |
  | Packet Length    | 02 40             | Max IPX size (576 bytes|
  |                  |                   | Hi Lo order)           |
  | Trans Control    | 00                | Hops traversed         |
  | Packet Type      | 04                | Packet Exchange Packet |
  | Dest Net #       | 00 00 00 00       | Local Network          |
  | Dest Node #      | FF FF FF FF FF FF | Broadcast              |
  | Dest Socket #    | 90 04             | Reserved WAN socket    |
  | Source Net #     | 00 00 00 00       | Local Network          |
  | Source Node #    | 00 00 00 00 00 00 | Set to zero            |
  | Source Socket #  | 90 04             | Reserved WAN socket    |
  |------------------+-------------------+------------------------|
  | WIdentifier      | 57 41 53 4D       | Confidence identifier  |
  | WPacket Type     | 01                | Timer Response         |
  | WNode ID         | xx xx xx xx       | Primary Net # of       |
  |                  |                   | sending router         |
  |                  |                   | (Hi Lo order)          |
  | WSequence #      | xx                | Same as Timer Request  |
  |                  |                   | received               |
  | WNum Options     | 02                | 2 Options follow       |
  | WOption Number   | 00                | Define Routing Type    |
  | WAccept Option   | 01                | 0=No,1=Yes,3=Not Applic|
  | WOption Data Len | 00 01             | Option length (Hi Lo)  |
  | WOption Data     | 00                | IPX RIP/SAP Routing    |
  |                  |                   | (Minimum interoperating|
  |                  |                   | requirement). Others   |
  |                  |                   | may be defined by at a |
  |                  |                   | later date by Novell   |
  | WOption Number   | FF                | Pad option             |
  | WAccept Option   | 01                | 0=No,1=Yes,3=Not Applic|
  | WOption Data Len | 02 0E             | Pad data length (Hi Lo)|
  | WOption Data     | 00->FF's          | Repeated sequence of 00|
  |                  |                   | through FF's to stop   |
  |                  |                   | compression modems     |
  |                  |                   | doing any compression  |
  |                  |                   | for link delay calc.   |
  +---------------------------------------------------------------+

  The responses contained within this packet are as described in
  section 4.1. Any unknown options or not supported options from the
  Timer Request should have the WAccept Option set to NO.

  If the Timer Request packet contained more than one Router Type
  option and the "Slave" supports all the options, the "Slave" should
  set the WAccept Option to NO on all Router Types except the Routing



Allen                                                           [Page 8]

RFC 1362                         IPXWAN                   September 1992


  Type which is to be adopted. The "Master" of the link will then adopt
  the routing option specified with the YES setting and complete
  further information exchanges according to that routing standard.

  This packet should contain the same sequence number as the received
  Timer Request. This packet should ONLY be sent by the router
  determining themselves to be the "Slave" of the link.

  Currently Assigned WOption Numbers (Timer Response Packet):
      Routing Type Option = 0x00;     Option Length = 0001
          Current option data values:
             0       Novell RIP/SAP routing with network
                     number assigned to the link.

      PAD Type Option     = 0xFF;     Option Length = Variable

      Compression Option  = 0x80;     Option Length = Variable
                        (length dependant on compression type)
          Current option data values:
              Byte 1  Compression type
                  0 = Telebit compression (length=3) [6]
                  Telebit Byte 2 - Compression options
                  Telebit Byte 3 - Number compression slots




























Allen                                                           [Page 9]

RFC 1362                         IPXWAN                   September 1992


4.3. RIP/SAP Information Request Packet (Router Type=0 Only)

  +---------------------------------------------------------------+
  | Checksum         | FF FF             | Always FFFF            |
  | Packet Length    | 00 63             | Size of header+data    |
  |                  |                   | (Hi Lo order)          |
  | Trans Control    | 00                | Hops traversed         |
  | Packet Type      | 04                | Packet Exchange Packet |
  | Dest Net #       | 00 00 00 00       | Local Network          |
  | Dest Node #      | FF FF FF FF FF FF | Broadcast              |
  | Dest Socket #    | 90 04             | Reserved WAN socket    |
  | Source Net #     | 00 00 00 00       | Local Network          |
  | Source Node #    | 00 00 00 00 00 00 | Set to zero            |
  | Source Socket #  | 90 04             | Reserved WAN socket    |
  |------------------+-------------------+------------------------|
  | WIdentifier      | 57 41 53 4D       | Confidence identifier  |
  | WPacket Type     | 02                | Information Request    |
  | WNode ID         | xx xx xx xx       | Primary Net # of       |
  |                  |                   | sending router         |
  |                  |                   | (Hi Lo order)          |
  | WSequence #      | 00                | Sequence start at 0    |
  | WNum Options     | 01                | 1 Option to follow     |
  | WOption Number   | 01                | Define IPX RIP/SAP     |
  |                  |                   | info exchange          |
  | WAccept Option   | 01                | 0=No,1=Yes,3=Not Applic|
  | WOption Data Len | 00 36             | Option length (Hi Lo)  |
  | WOption Data     |                   |                        |
  |  Link Delay      | xx xx             | Hi Lo link delay in    |
  |                  |                   | milli seconds (see     |
  |                  |                   | below for calculation) |
  |  Common Net #    | xx xx xx xx       | Hi Lo Common Network # |
  |  Router Name     | xx (x 48 decimal) | Router name - as defned|
  |                  |                   | in section 2.          |
  +---------------------------------------------------------------+

















Allen                                                          [Page 10]

RFC 1362                         IPXWAN                   September 1992


Calculation of link delay is performed as follows:

  // Start_time is a time stamp when Timer Request sent out
  // End_time is a time stamp when a Timer Response is
  // received.
  link_delay = end_time - start_time; // 1/18th second
  // We are on a slow net, so add some biasing to help stop
  // multiple workstation sessions timing out on the link
  if (link_delay < 1)
  {
      link_delay = 1;
  }/*IF*/
  link_delay *= 6;   // Add the biasing
  link_delay *= 55;  // Convert link delay to milliseconds

  The "Link Delay" is used as the network transport time when
  advertized in the IPX RIP packet tuple for the network entry "Common
  Net #". For a consistent network, a common link delay is required at
  both ends of the link and is calculated by the link "Master".

  The Common Net # is supplied by the link "Master". This number must
  be unique in the connected internetwork. Each WAN call requires a
  separate number.

  Currently only a single option is defined for the "Information
  Request" packet for Routing Type=0.

























Allen                                                          [Page 11]

RFC 1362                         IPXWAN                   September 1992


4.4. RIP/SAP Information Response Packet (Router Type=0 Only)

  +---------------------------------------------------------------+
  | Checksum         | FF FF             | Always FFFF            |
  | Packet Length    | 00 63             | Size of header+data    |
  |                  |                   | (Hi Lo Order)          |
  | Trans Control    | 00                | Hops traversed         |
  | Packet Type      | 04                | Packet Exchange Packet |
  | Dest Net #       | 00 00 00 00       | Local Network          |
  | Dest Node #      | FF FF FF FF FF FF | Broadcast              |
  | Dest Socket #    | 90 04             | Reserved WAN socket    |
  | Source Net #     | 00 00 00 00       | Local Network          |
  | Source Node #    | 00 00 00 00 00 00 | Set to zero            |
  | Source Socket #  | 90 04             | Reserved WAN socket    |
  |------------------+-------------------+------------------------|
  | WIdentifier      | 57 41 53 4D       | Confidence identifier  |
  | WPacket Type     | 03                | Information Response   |
  | WNode ID         | xx xx xx xx       | Primary Net # of       |
  |                  |                   | sending router         |
  |                  |                   | (Hi Lo order)          |
  | WSequence #      | 00                | Sequence start at 0    |
  | WNum Options     | 01                | 1 Option to follow     |
  | WOption Number   | 01                | Define IPX RIP/SAP     |
  |                  |                   | info exchange          |
  | WAccept Option   | 01                | 0=No,1=Yes,3=Not Applic|
  | WOption Data Len | 00 36             | Option length (Hi Lo)  |
  | WOption Data     |                   |                        |
  |  Link Delay      | xx xx             | Hi Lo link delay (as   |
  |                  |                   | received in Info Requ) |
  |  Common Net #    | xx xx xx xx       | Hi Lo Common Network # |
  |                  |                   | (as received in Info   |
  |                  |                   | request)               |
  |  Router Name     | xx (x 48 decimal) | Router name - as defned|
  |                  |                   | in section 2.          |
  +---------------------------------------------------------------+

  The responses contained within this packet are as described in
  section 4.3.

5. References

  [1] Simpson, W., "The Point-to-Point Protocol (PPP) for the
      Transmission of Multi-protocol Datagrams over Point-to-Point
      Links", RFC 1331, May 1992.

  [2] Malis, A., Robinson, D., and R. Ullman, "Multiprotocol
      Interconnect on X.25 and ISDN in the Packet Mode", RFC 1356,
      August 1992.



Allen                                                          [Page 12]

RFC 1362                         IPXWAN                   September 1992


  [3] Bradley, T., Brown, C., and A. Malis, "Multiprotocol Interconnect
      over Frame Relay", RFC 1294, January 1992.

  [4] Simpson, W., "The PPP Internetwork Packet Exchange Control
      Protocol (IPXCP) Compromise Version", Work in Progress.

  [5] Novell IPX Router Specification. Novell Part Number 107-000029-
      001. (Note:  Currently, this document is only available as part
      of a Novell developers program as part of an SDK. Novell Labs,
      Provo (UT) should be able to provide more information on this
      document.)

  [6] Lewis, M., Telebit Corp. "IPX Header Compression based on Van
      Jacobson Header Compression for TCP/IP", Work in Progress,
      contact: ([email protected]).

6. Security Considerations

      Security issues are not discussed in this memo.

7. Author's Address

      Michael Allen
      Novell, Inc.
      2180 Fortune Drive
      San Jose, CA 95131

      EMail: [email protected]

      Chair's Address:

      The working group can be contacted via the current chair:

      Brian Lloyd
      Lloyd & Associates
      3420 Sudbury Road
      Cameron Park, California 95682

      EMail: [email protected]

      Phone: (916) 676-1147










Allen                                                          [Page 13]