home *** CD-ROM | disk | FTP | other *** search
/ Handbook of Infosec Terms 2.0 / Handbook_of_Infosec_Terms_Version_2.0_ISSO.iso / text / rfcs / rfc1792.txt < prev    next >
Text File  |  1996-05-07  |  17KB  |  237 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                            T. Sung Request for Comments: 1792                                  Novell, Inc. Category: Experimental                                        April 1995 
  8.  
  9.                    TCP/IPX Connection Mib Specification 
  10.  
  11. Status of this Memo 
  12.  
  13.    This document defines an Experimental Protocol for the Internet    community.  This does not specify an Internet standard of any kind.    Discussion and suggestions for improvement are requested.    Distribution of this memo is unlimited. 
  14.  
  15. IESG Note: 
  16.  
  17.    Internet Engineering Steering Group comment from the Area Director    for Transport Services: Please note well that this memo is an    individual product of the author.  Implementation experience,    particularly on the effectiveness of the protocols in dual-stack    environments, is needed. 
  18.  
  19. 1.  Introduction 
  20.  
  21.    Traditionally, TCP and UDP runs over IP.  STD 17, RFC 1213 defines    TCP connection MIB object and UDP listener object assuming just that.    For TCP and UDP running over IPX, tcpConnTable and udpTable objects    from RFC 1213 cannot be used since they define the address to be of    type IpAddress.  As such, we need to define new objects that can    properly describe TCP and UDP connections over IPX. 
  22.  
  23.    New MIB objects, tcpIpxConnTable, udpIpxTable, tcpUnspecConnTable and    udpUnspecTable are presented in this paper, to be used in place of    tcpConnTable and udpListenerTable when TCP and UDP are running over    IPX. 
  24.  
  25. 2.  Objects 
  26.  
  27.            TCPIPX-MIB DEFINITIONS ::= BEGIN 
  28.  
  29.            IMPORTS                    OBJECT-TYPE                            FROM RFC-1212; 
  30.  
  31.          -- IPX address type.         -- First 4 octests are the network numbers and the last 6         -- octests are the node numbers.  In ascii, it is represented 
  32.  
  33.  
  34.  
  35. Sung                                                            [Page 1] 
  36.  RFC 1792                      TCP/IPX MIB                     April 1995 
  37.  
  38.          -- as hex digits, as in:  nnnnnnnn:mmmmmmmmmmmm 
  39.  
  40.         IpxAddress ::= OCTET STRING (size (10)) 
  41.  
  42.            -- TCP/IPX MIB object idenfifiers 
  43.  
  44.         novell        OBJECT IDENTIFIER ::= { enterprises 23 }         mibDoc        OBJECT IDENTIFIER ::= { novell 2 }         tcpx          OBJECT IDENTIFIER ::= { mibDoc 29 }         tcpxTcp       OBJECT IDENTIFIER ::= { tcpx 1 }         tcpxUdp       OBJECT IDENTIFIER ::= { tcpx 2 } 
  45.  
  46.  
  47.  
  48.           -- the TCP/IPX Connection table 
  49.  
  50.            -- The TCP/IPX connection table contains information            -- about this entity's existing TCP connections over            -- IPX. 
  51.  
  52.            tcpIpxConnTable OBJECT-TYPE                SYNTAX  SEQUENCE OF TcpIpxConnEntry                ACCESS  not-accessible                STATUS  mandatory                DESCRIPTION                        "A table containing information specific on                        TCP connection over IPX network layer." 
  53.  
  54.                ::= { tcpxTcp 1 } 
  55.  
  56.            tcpIpxConnEntry OBJECT-TYPE                SYNTAX  TcpIpxConnEntry                ACCESS  not-accessible                STATUS  mandatory                DESCRIPTION                        "Information about a particular current TCP                        connection over IPX  An object of this type is                        transient, in that it ceases to exist when (or                        soon after) the connection makes the transition                        to the CLOSED state."                INDEX   { tcpIpxConnLocalAddress,                          tcpIpxConnLocalPort,                          tcpIpxConnRemAddress,                          tcpIpxConnRemPort }               ::= { tcpIpxConnTable 1 } 
  57.  
  58.            TcpIpxConnEntry ::=                SEQUENCE { 
  59.  
  60.  
  61.  
  62. Sung                                                            [Page 2] 
  63.  RFC 1792                      TCP/IPX MIB                     April 1995 
  64.  
  65.                     tcpIpxConnState                        INTEGER,                    tcpIpxConnLocalAddress                        IpxAddress                    tcpIpxConnLocalPort                        INTEGER (0..65535),                    tcpIpxConnRemAddress                        IpxAddress,                    tcpIpxConnRemPort                        INTEGER (0..65535)                } 
  66.  
  67.            tcpIpxConnState OBJECT-TYPE                SYNTAX  INTEGER {                            closed(1),                            listen(2),                            synSent(3),                            synReceived(4),                            established(5),                            finWait1(6),                            finWait2(7),                            closeWait(8),                            lastAck(9),                            closing(10),                            timeWait(11),                            deleteTCB(12)                        }                ACCESS  read-write                STATUS  mandatory                DESCRIPTION                        "The state of this TCP connection. 
  68.  
  69.                        The only value which may be set by a management                        station is deleteTCB(12).  Accordingly, it is                        appropriate for an agent to return a `badValue'                        response if a management station attempts to set                        this object to any other value. 
  70.  
  71.                        If a management station sets this object to the                        value deleteTCB(12), then this has the effect of                        deleting the TCB (as defined in RFC 793) of the                        corresponding connection on the managed node,                        resulting in immediate termination of the                        connection. 
  72.  
  73.                        As an implementation-specific option, a RST                        segment may be sent from the managed node to the                        other TCP endpoint (note however that RST 
  74.  
  75.  
  76.  
  77. Sung                                                            [Page 3] 
  78.  RFC 1792                      TCP/IPX MIB                     April 1995 
  79.  
  80.                         segments are not sent reliably)."                ::= { tcpIpxConnEntry 1 } 
  81.  
  82.            tcpIpxConnLocalAddress OBJECT-TYPE                SYNTAX  IpxAddress                ACCESS  read-only                STATUS  mandatory                DESCRIPTION                        "The local IPX address for this TCP connection.                        In the case of a connection in the listen state                        which is willing to accept connections for any                        interface, the value 00000000:000000000000 is                        used.  See tcpUnspecConnTable for connections in                        the listen  state which is willing to accept                        connects for any IP interface associated with                        the node."                ::= { tcpIpxConnEntry 2 } 
  83.  
  84.            -- NetworkAddress defined in SMI only include IP currently,            -- so we can't use it to represent both IP and IPX address. 
  85.  
  86.            tcpIpxConnLocalPort OBJECT-TYPE                SYNTAX  INTEGER (0..65535)                ACCESS  read-only                STATUS  mandatory                DESCRIPTION                        "The local port number for this TCP connection."                ::= { tcpIpxConnEntry 3 } 
  87.  
  88.            tcpIpxConnRemAddress OBJECT-TYPE                SYNTAX  IpxAddress                ACCESS  read-only                STATUS  mandatory                DESCRIPTION                        "The remote IPX address for this TCP connection."                ::= { tcpIpxConnEntry 4 } 
  89.  
  90.            tcpIpxConnRemPort OBJECT-TYPE                SYNTAX  INTEGER (0..65535)                ACCESS  read-only                STATUS  mandatory                DESCRIPTION                        "The remote port number for this TCP connection."                ::= { tcpIpxConnEntry 5 } 
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98. Sung                                                            [Page 4] 
  99.  RFC 1792                      TCP/IPX MIB                     April 1995 
  100.  
  101.             -- the UDP Listener table 
  102.  
  103.            -- The UDP listener table contains information about this            -- entity's UDP end-points on which a local application is            -- currently accepting datagrams. 
  104.  
  105.            udpIpxTable OBJECT-TYPE                SYNTAX  SEQUENCE OF UdpIpxEntry                ACCESS  not-accessible                STATUS  mandatory                DESCRIPTION                        "A table containing UDP listener information."                ::= { tcpxUdp 1 } 
  106.  
  107.            udpIpxEntry OBJECT-TYPE                SYNTAX  UdpIpxEntry                ACCESS  not-accessible                STATUS  mandatory                DESCRIPTION                        "Information about a particular current UDP                        listener."                INDEX   { udpIpxLocalAddress, udpIpxLocalPort }                ::= { udpIpxTable 1 } 
  108.  
  109.            UdpIpxEntry ::=                SEQUENCE {                    udpIpxLocalAddress             IpxAddress                    udpIpxLocalPort                        INTEGER (0..65535)                } 
  110.  
  111.            udpIpxLocalAddress OBJECT-TYPE                SYNTAX  IpxAddress                ACCESS  read-only                STATUS  mandatory                DESCRIPTION                        "The local IPX address for this UDP listener.  In                        the case of a UDP listener which is willing to                        accept datagrams for any interface, the value                        00000000:000000000000 is used.  See                        udpUnspecTable for UDP listener which is                        willing to accept datagrams from any network                        layer."                ::= { udpIpxEntry 1 } 
  112.  
  113.            udpIpxLocalPort OBJECT-TYPE                SYNTAX  INTEGER (0..65535) 
  114.  
  115.  
  116.  
  117. Sung                                                            [Page 5] 
  118.  RFC 1792                      TCP/IPX MIB                     April 1995 
  119.  
  120.                 ACCESS  read-only                STATUS  mandatory                DESCRIPTION                        "The local port number for this UDP listener."                ::= { udpIpxEntry 2 } 
  121.  
  122.             -- the TCP/UNSPEC Connection table 
  123.  
  124.            -- The TCP/UPSPEC connection table contains information            -- about this entity's existing TCP connections over            -- unspecified network.            -- Since the network is unspecified, the network            -- address is also unspecified.  Hence, this            -- connection table does not include any network            -- address. 
  125.  
  126.            tcpUnspecConnTable OBJECT-TYPE                SYNTAX  SEQUENCE OF TcpIpxConnEntry                ACCESS  not-accessible                STATUS  mandatory                DESCRIPTION                        "A table containing information specific on                        TCP connection over unspecified network layer." 
  127.  
  128.                ::= { tcpxTcp 2 } 
  129.  
  130.            tcpUnspecConnEntry OBJECT-TYPE                SYNTAX  TcpUnspecConnEntry                ACCESS  not-accessible                STATUS  mandatory                DESCRIPTION                        "Information about a particular current TCP                        connection over unspecified network layer.  An                        object of this type is transient, in that it                        ceases to exist when the connection makes                        transition beyond LISTEN state, or when (or                        soon after) the connection makes transition                        to the CLOSED state," 
  131.  
  132.                INDEX   { tcpUnspecConnLocalPort }                ::= { tcpUnspecConnTable 1 } 
  133.  
  134.            TcpUnspecConnEntry ::=                SEQUENCE {                    tcpUnspecConnState                        INTEGER,                    tcpUnspecConnLocalPort 
  135.  
  136.  
  137.  
  138. Sung                                                            [Page 6] 
  139.  RFC 1792                      TCP/IPX MIB                     April 1995 
  140.  
  141.                         INTEGER (0..65535),                } 
  142.  
  143.            tcpUnspecConnState OBJECT-TYPE                SYNTAX  INTEGER {                            closed(1),                            listen(2),                            deleteTCB(12)                        }                ACCESS  read-write                STATUS  mandatory                DESCRIPTION                        "The state of this TCP connection. 
  144.  
  145.                        Since the TCP connection can belong to this table                        only when its state is less than SYN_SENT, only                        closed and listen state apply. 
  146.  
  147.                        The only value which may be set by a management                        station is deleteTCB(12).  Accordingly, it is                        appropriate for an agent to return a `badValue'                        response if a management station attempts to set                        this object to any other value. 
  148.  
  149.                        If a management station sets this object to the                        value deleteTCB(12), then this has the effect of                        deleting the TCB (as defined in RFC 793) of the                        corresponding connection on the managed node,                        resulting in immediate termination of the                        connection. 
  150.  
  151.                        As an implementation-specific option, a RST                        segment may be sent from the managed node to the                        other TCP endpoint (note however that RST                        segments are not sent reliably)."                ::= { tcpUnspecConnEntry 1 } 
  152.  
  153.            tcpUnspecConnLocalPort OBJECT-TYPE                SYNTAX  INTEGER (0..65535)                ACCESS  read-only                STATUS  mandatory                DESCRIPTION                        "The local port number for this TCP connection."                ::= { tcpUnspecConnEntry 2 } 
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161. Sung                                                            [Page 7] 
  162.  RFC 1792                      TCP/IPX MIB                     April 1995 
  163.  
  164.             -- the UDP Listener table 
  165.  
  166.            -- The UDP listener table contains information about this            -- entity's UDP end-points over unspecified network layer,            -- on which a local application is currently accepting            -- datagrams.  If network layer is unspecified, the network            -- address is also unspecified.  Hence, this table does not            -- include any network address. 
  167.  
  168.            udpUnspecTable OBJECT-TYPE                SYNTAX  SEQUENCE OF UdpUnspecEntry                ACCESS  not-accessible                STATUS  mandatory                DESCRIPTION                         "A table containing UDP listener information."                ::= { tcpxUdp 2 } 
  169.  
  170.            udpUnspecEntry OBJECT-TYPE                SYNTAX  UdpUnspecEntry                ACCESS  not-accessible                STATUS  mandatory                DESCRIPTION                        "Information about a particular current UDP                        listener."                INDEX   { udpUnspecLocalPort }                ::= { udpUnspecTable 1 } 
  171.  
  172.            UdpUnspecEntry ::=                SEQUENCE {                    udpUnspecLocalPort                        INTEGER (0..65535)                } 
  173.  
  174.            udpUnspecLocalPort OBJECT-TYPE                SYNTAX  INTEGER (0..65535)                ACCESS  read-only                STATUS  mandatory                DESCRIPTION                        "The local port number for this UDP listener."                ::= { udpUnspecEntry 1 } 
  175.  
  176.             END 
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186. Sung                                                            [Page 8] 
  187.  RFC 1792                      TCP/IPX MIB                     April 1995 
  188.  
  189.  Acknowledgement 
  190.  
  191.    The author would like to thank following folks and others for their    assitance: Greg Minshall, Dave Piscitello. 
  192.  
  193. Security Considerations 
  194.  
  195.    Security issues are not discussed in this memo. 
  196.  
  197. Author's Address 
  198.  
  199.    Tae Sung    Novell, Inc.    2180 Fortune Drive    San Jose, California, 95131 
  200.  
  201.    Phone: (408)577-8439    EMail: tae@novell.Com 
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235. Sung                                                            [Page 9] 
  236.  
  237.