home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / rfc / 3 / rfc1792.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  16.0 KB  |  508 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                            T. Sung
  8. Request for Comments: 1792                                  Novell, Inc.
  9. Category: Experimental                                        April 1995
  10.  
  11.  
  12.                   TCP/IPX Connection Mib Specification
  13.  
  14. Status of this Memo
  15.  
  16.    This document defines an Experimental Protocol for the Internet
  17.    community.  This does not specify an Internet standard of any kind.
  18.    Discussion and suggestions for improvement are requested.
  19.    Distribution of this memo is unlimited.
  20.  
  21. IESG Note:
  22.  
  23.    Internet Engineering Steering Group comment from the Area Director
  24.    for Transport Services: Please note well that this memo is an
  25.    individual product of the author.  Implementation experience,
  26.    particularly on the effectiveness of the protocols in dual-stack
  27.    environments, is needed.
  28.  
  29. 1.  Introduction
  30.  
  31.    Traditionally, TCP and UDP runs over IP.  STD 17, RFC 1213 defines
  32.    TCP connection MIB object and UDP listener object assuming just that.
  33.    For TCP and UDP running over IPX, tcpConnTable and udpTable objects
  34.    from RFC 1213 cannot be used since they define the address to be of
  35.    type IpAddress.  As such, we need to define new objects that can
  36.    properly describe TCP and UDP connections over IPX.
  37.  
  38.    New MIB objects, tcpIpxConnTable, udpIpxTable, tcpUnspecConnTable and
  39.    udpUnspecTable are presented in this paper, to be used in place of
  40.    tcpConnTable and udpListenerTable when TCP and UDP are running over
  41.    IPX.
  42.  
  43. 2.  Objects
  44.  
  45.            TCPIPX-MIB DEFINITIONS ::= BEGIN
  46.  
  47.            IMPORTS
  48.                    OBJECT-TYPE
  49.                            FROM RFC-1212;
  50.  
  51.  
  52.         -- IPX address type.
  53.         -- First 4 octests are the network numbers and the last 6
  54.         -- octests are the node numbers.  In ascii, it is represented
  55.  
  56.  
  57.  
  58. Sung                                                            [Page 1]
  59.  
  60. RFC 1792                      TCP/IPX MIB                     April 1995
  61.  
  62.  
  63.         -- as hex digits, as in:  nnnnnnnn:mmmmmmmmmmmm
  64.  
  65.         IpxAddress ::= OCTET STRING (size (10))
  66.  
  67.            -- TCP/IPX MIB object idenfifiers
  68.  
  69.         novell        OBJECT IDENTIFIER ::= { enterprises 23 }
  70.         mibDoc        OBJECT IDENTIFIER ::= { novell 2 }
  71.         tcpx          OBJECT IDENTIFIER ::= { mibDoc 29 }
  72.         tcpxTcp       OBJECT IDENTIFIER ::= { tcpx 1 }
  73.         tcpxUdp       OBJECT IDENTIFIER ::= { tcpx 2 }
  74.  
  75.  
  76.  
  77.           -- the TCP/IPX Connection table
  78.  
  79.            -- The TCP/IPX connection table contains information
  80.            -- about this entity's existing TCP connections over
  81.            -- IPX.
  82.  
  83.            tcpIpxConnTable OBJECT-TYPE
  84.                SYNTAX  SEQUENCE OF TcpIpxConnEntry
  85.                ACCESS  not-accessible
  86.                STATUS  mandatory
  87.                DESCRIPTION
  88.                        "A table containing information specific on
  89.                        TCP connection over IPX network layer."
  90.  
  91.                ::= { tcpxTcp 1 }
  92.  
  93.            tcpIpxConnEntry OBJECT-TYPE
  94.                SYNTAX  TcpIpxConnEntry
  95.                ACCESS  not-accessible
  96.                STATUS  mandatory
  97.                DESCRIPTION
  98.                        "Information about a particular current TCP
  99.                        connection over IPX  An object of this type is
  100.                        transient, in that it ceases to exist when (or
  101.                        soon after) the connection makes the transition
  102.                        to the CLOSED state."
  103.                INDEX   { tcpIpxConnLocalAddress,
  104.                          tcpIpxConnLocalPort,
  105.                          tcpIpxConnRemAddress,
  106.                          tcpIpxConnRemPort }
  107.               ::= { tcpIpxConnTable 1 }
  108.  
  109.            TcpIpxConnEntry ::=
  110.                SEQUENCE {
  111.  
  112.  
  113.  
  114. Sung                                                            [Page 2]
  115.  
  116. RFC 1792                      TCP/IPX MIB                     April 1995
  117.  
  118.  
  119.                    tcpIpxConnState
  120.                        INTEGER,
  121.                    tcpIpxConnLocalAddress
  122.                        IpxAddress
  123.                    tcpIpxConnLocalPort
  124.                        INTEGER (0..65535),
  125.                    tcpIpxConnRemAddress
  126.                        IpxAddress,
  127.                    tcpIpxConnRemPort
  128.                        INTEGER (0..65535)
  129.                }
  130.  
  131.            tcpIpxConnState OBJECT-TYPE
  132.                SYNTAX  INTEGER {
  133.                            closed(1),
  134.                            listen(2),
  135.                            synSent(3),
  136.                            synReceived(4),
  137.                            established(5),
  138.                            finWait1(6),
  139.                            finWait2(7),
  140.                            closeWait(8),
  141.                            lastAck(9),
  142.                            closing(10),
  143.                            timeWait(11),
  144.                            deleteTCB(12)
  145.                        }
  146.                ACCESS  read-write
  147.                STATUS  mandatory
  148.                DESCRIPTION
  149.                        "The state of this TCP connection.
  150.  
  151.                        The only value which may be set by a management
  152.                        station is deleteTCB(12).  Accordingly, it is
  153.                        appropriate for an agent to return a `badValue'
  154.                        response if a management station attempts to set
  155.                        this object to any other value.
  156.  
  157.                        If a management station sets this object to the
  158.                        value deleteTCB(12), then this has the effect of
  159.                        deleting the TCB (as defined in RFC 793) of the
  160.                        corresponding connection on the managed node,
  161.                        resulting in immediate termination of the
  162.                        connection.
  163.  
  164.                        As an implementation-specific option, a RST
  165.                        segment may be sent from the managed node to the
  166.                        other TCP endpoint (note however that RST
  167.  
  168.  
  169.  
  170. Sung                                                            [Page 3]
  171.  
  172. RFC 1792                      TCP/IPX MIB                     April 1995
  173.  
  174.  
  175.                        segments are not sent reliably)."
  176.                ::= { tcpIpxConnEntry 1 }
  177.  
  178.            tcpIpxConnLocalAddress OBJECT-TYPE
  179.                SYNTAX  IpxAddress
  180.                ACCESS  read-only
  181.                STATUS  mandatory
  182.                DESCRIPTION
  183.                        "The local IPX address for this TCP connection.
  184.                        In the case of a connection in the listen state
  185.                        which is willing to accept connections for any
  186.                        interface, the value 00000000:000000000000 is
  187.                        used.  See tcpUnspecConnTable for connections in
  188.                        the listen  state which is willing to accept
  189.                        connects for any IP interface associated with
  190.                        the node."
  191.                ::= { tcpIpxConnEntry 2 }
  192.  
  193.            -- NetworkAddress defined in SMI only include IP currently,
  194.            -- so we can't use it to represent both IP and IPX address.
  195.  
  196.            tcpIpxConnLocalPort OBJECT-TYPE
  197.                SYNTAX  INTEGER (0..65535)
  198.                ACCESS  read-only
  199.                STATUS  mandatory
  200.                DESCRIPTION
  201.                        "The local port number for this TCP connection."
  202.                ::= { tcpIpxConnEntry 3 }
  203.  
  204.            tcpIpxConnRemAddress OBJECT-TYPE
  205.                SYNTAX  IpxAddress
  206.                ACCESS  read-only
  207.                STATUS  mandatory
  208.                DESCRIPTION
  209.                        "The remote IPX address for this TCP connection."
  210.                ::= { tcpIpxConnEntry 4 }
  211.  
  212.            tcpIpxConnRemPort OBJECT-TYPE
  213.                SYNTAX  INTEGER (0..65535)
  214.                ACCESS  read-only
  215.                STATUS  mandatory
  216.                DESCRIPTION
  217.                        "The remote port number for this TCP connection."
  218.                ::= { tcpIpxConnEntry 5 }
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226. Sung                                                            [Page 4]
  227.  
  228. RFC 1792                      TCP/IPX MIB                     April 1995
  229.  
  230.  
  231.            -- the UDP Listener table
  232.  
  233.            -- The UDP listener table contains information about this
  234.            -- entity's UDP end-points on which a local application is
  235.            -- currently accepting datagrams.
  236.  
  237.            udpIpxTable OBJECT-TYPE
  238.                SYNTAX  SEQUENCE OF UdpIpxEntry
  239.                ACCESS  not-accessible
  240.                STATUS  mandatory
  241.                DESCRIPTION
  242.                        "A table containing UDP listener information."
  243.                ::= { tcpxUdp 1 }
  244.  
  245.            udpIpxEntry OBJECT-TYPE
  246.                SYNTAX  UdpIpxEntry
  247.                ACCESS  not-accessible
  248.                STATUS  mandatory
  249.                DESCRIPTION
  250.                        "Information about a particular current UDP
  251.                        listener."
  252.                INDEX   { udpIpxLocalAddress, udpIpxLocalPort }
  253.                ::= { udpIpxTable 1 }
  254.  
  255.            UdpIpxEntry ::=
  256.                SEQUENCE {
  257.                    udpIpxLocalAddress
  258.             IpxAddress
  259.                    udpIpxLocalPort
  260.                        INTEGER (0..65535)
  261.                }
  262.  
  263.            udpIpxLocalAddress OBJECT-TYPE
  264.                SYNTAX  IpxAddress
  265.                ACCESS  read-only
  266.                STATUS  mandatory
  267.                DESCRIPTION
  268.                        "The local IPX address for this UDP listener.  In
  269.                        the case of a UDP listener which is willing to
  270.                        accept datagrams for any interface, the value
  271.                        00000000:000000000000 is used.  See
  272.                        udpUnspecTable for UDP listener which is
  273.                        willing to accept datagrams from any network
  274.                        layer."
  275.                ::= { udpIpxEntry 1 }
  276.  
  277.            udpIpxLocalPort OBJECT-TYPE
  278.                SYNTAX  INTEGER (0..65535)
  279.  
  280.  
  281.  
  282. Sung                                                            [Page 5]
  283.  
  284. RFC 1792                      TCP/IPX MIB                     April 1995
  285.  
  286.  
  287.                ACCESS  read-only
  288.                STATUS  mandatory
  289.                DESCRIPTION
  290.                        "The local port number for this UDP listener."
  291.                ::= { udpIpxEntry 2 }
  292.  
  293.  
  294.            -- the TCP/UNSPEC Connection table
  295.  
  296.            -- The TCP/UPSPEC connection table contains information
  297.            -- about this entity's existing TCP connections over
  298.            -- unspecified network.
  299.            -- Since the network is unspecified, the network
  300.            -- address is also unspecified.  Hence, this
  301.            -- connection table does not include any network
  302.            -- address.
  303.  
  304.            tcpUnspecConnTable OBJECT-TYPE
  305.                SYNTAX  SEQUENCE OF TcpIpxConnEntry
  306.                ACCESS  not-accessible
  307.                STATUS  mandatory
  308.                DESCRIPTION
  309.                        "A table containing information specific on
  310.                        TCP connection over unspecified network layer."
  311.  
  312.                ::= { tcpxTcp 2 }
  313.  
  314.            tcpUnspecConnEntry OBJECT-TYPE
  315.                SYNTAX  TcpUnspecConnEntry
  316.                ACCESS  not-accessible
  317.                STATUS  mandatory
  318.                DESCRIPTION
  319.                        "Information about a particular current TCP
  320.                        connection over unspecified network layer.  An
  321.                        object of this type is transient, in that it
  322.                        ceases to exist when the connection makes
  323.                        transition beyond LISTEN state, or when (or
  324.                        soon after) the connection makes transition
  325.                        to the CLOSED state,"
  326.  
  327.                INDEX   { tcpUnspecConnLocalPort }
  328.                ::= { tcpUnspecConnTable 1 }
  329.  
  330.            TcpUnspecConnEntry ::=
  331.                SEQUENCE {
  332.                    tcpUnspecConnState
  333.                        INTEGER,
  334.                    tcpUnspecConnLocalPort
  335.  
  336.  
  337.  
  338. Sung                                                            [Page 6]
  339.  
  340. RFC 1792                      TCP/IPX MIB                     April 1995
  341.  
  342.  
  343.                        INTEGER (0..65535),
  344.                }
  345.  
  346.            tcpUnspecConnState OBJECT-TYPE
  347.                SYNTAX  INTEGER {
  348.                            closed(1),
  349.                            listen(2),
  350.                            deleteTCB(12)
  351.                        }
  352.                ACCESS  read-write
  353.                STATUS  mandatory
  354.                DESCRIPTION
  355.                        "The state of this TCP connection.
  356.  
  357.                        Since the TCP connection can belong to this table
  358.                        only when its state is less than SYN_SENT, only
  359.                        closed and listen state apply.
  360.  
  361.                        The only value which may be set by a management
  362.                        station is deleteTCB(12).  Accordingly, it is
  363.                        appropriate for an agent to return a `badValue'
  364.                        response if a management station attempts to set
  365.                        this object to any other value.
  366.  
  367.                        If a management station sets this object to the
  368.                        value deleteTCB(12), then this has the effect of
  369.                        deleting the TCB (as defined in RFC 793) of the
  370.                        corresponding connection on the managed node,
  371.                        resulting in immediate termination of the
  372.                        connection.
  373.  
  374.                        As an implementation-specific option, a RST
  375.                        segment may be sent from the managed node to the
  376.                        other TCP endpoint (note however that RST
  377.                        segments are not sent reliably)."
  378.                ::= { tcpUnspecConnEntry 1 }
  379.  
  380.            tcpUnspecConnLocalPort OBJECT-TYPE
  381.                SYNTAX  INTEGER (0..65535)
  382.                ACCESS  read-only
  383.                STATUS  mandatory
  384.                DESCRIPTION
  385.                        "The local port number for this TCP connection."
  386.                ::= { tcpUnspecConnEntry 2 }
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394. Sung                                                            [Page 7]
  395.  
  396. RFC 1792                      TCP/IPX MIB                     April 1995
  397.  
  398.  
  399.            -- the UDP Listener table
  400.  
  401.            -- The UDP listener table contains information about this
  402.            -- entity's UDP end-points over unspecified network layer,
  403.            -- on which a local application is currently accepting
  404.            -- datagrams.  If network layer is unspecified, the network
  405.            -- address is also unspecified.  Hence, this table does not
  406.            -- include any network address.
  407.  
  408.            udpUnspecTable OBJECT-TYPE
  409.                SYNTAX  SEQUENCE OF UdpUnspecEntry
  410.                ACCESS  not-accessible
  411.                STATUS  mandatory
  412.                DESCRIPTION
  413.                         "A table containing UDP listener information."
  414.                ::= { tcpxUdp 2 }
  415.  
  416.            udpUnspecEntry OBJECT-TYPE
  417.                SYNTAX  UdpUnspecEntry
  418.                ACCESS  not-accessible
  419.                STATUS  mandatory
  420.                DESCRIPTION
  421.                        "Information about a particular current UDP
  422.                        listener."
  423.                INDEX   { udpUnspecLocalPort }
  424.                ::= { udpUnspecTable 1 }
  425.  
  426.            UdpUnspecEntry ::=
  427.                SEQUENCE {
  428.                    udpUnspecLocalPort
  429.                        INTEGER (0..65535)
  430.                }
  431.  
  432.            udpUnspecLocalPort OBJECT-TYPE
  433.                SYNTAX  INTEGER (0..65535)
  434.                ACCESS  read-only
  435.                STATUS  mandatory
  436.                DESCRIPTION
  437.                        "The local port number for this UDP listener."
  438.                ::= { udpUnspecEntry 1 }
  439.  
  440.             END
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450. Sung                                                            [Page 8]
  451.  
  452. RFC 1792                      TCP/IPX MIB                     April 1995
  453.  
  454.  
  455. Acknowledgement
  456.  
  457.    The author would like to thank following folks and others for their
  458.    assitance: Greg Minshall, Dave Piscitello.
  459.  
  460. Security Considerations
  461.  
  462.    Security issues are not discussed in this memo.
  463.  
  464. Author's Address
  465.  
  466.    Tae Sung
  467.    Novell, Inc.
  468.    2180 Fortune Drive
  469.    San Jose, California, 95131
  470.  
  471.    Phone: (408)577-8439
  472.    EMail: tae@novell.Com
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506. Sung                                                            [Page 9]
  507.  
  508.