RE: Updating the MIB boilerplate

["Wijnen, Bert (Bert)" <bwijnen@lucent.com>]

Mmm.. I would probably even insert it one sentence earlier.
How about:

------------- draft boiler plate for MIBs -----------

1.  The SNMP Management Framework

   For a detailed overview of the docments that describe the current
   Internet-Standard Management Framework, please refer to section 7
   of RFC2570bis [rfc2570bis].

   Managed objects are accessed via a virtual information store,
   termed the Management Information Base or MIB.  MIB objects are
   generally accessed through the Simple Network Management Protocol
   (SNMP).  Objects in the MIB are defined using the mechanisms
   defined in the Structure of Management Information (SMI).  This
   memo specifies a MIB module that is compliant to the SMIv2, which
   is described in STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579
   [RFC2579] and STD 58, RFC 2580 [RFC2580].

2.  Normative References

[RFC2578]   McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
            Rose, M., and S. Waldbusser, "Structure of Management
            Information Version 2 (SMIv2)", STD 58, RFC 2578, April
            1999.

[RFC2579]   McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
            Rose, M., and S. Waldbusser, "Textual Conventions for
            SMIv2", STD 58, RFC 2579, April 1999.

[RFC2580]   McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
            Rose, M., and S. Waldbusser, "Conformance Statements for
            SMIv2", STD 58, RFC 2580, April 1999.

3.  Informative References

[RFC2570bis]Case, J., Mundy, R., Partain, D., and B. Stewart,
            "Introduction to Version 3 of the Internet-standard Network
            Management Framework", RFC 3410, October 2002.


Thanks,
Bert 

> -----Original Message-----
> From: Wes Hardaker [mailto:wjhns1@hardakers.net]
> Sent: maandag 4 november 2002 16:01
> To: Wijnen, Bert (Bert)
> Cc: C. M. Heard; mibs@ops.ietf.org
> Subject: Re: Updating the MIB boilerplate
> 
> 
> >>>>> On Mon, 4 Nov 2002 12:10:12 +0100 , "Wijnen, Bert 
> (Bert)" <bwijnen@lucent.com> said:
> 
> Bert> Ok, to be more precise, how about a boilerplate as below.  I
> Bert> know that in some cases ref 2579 and 2580 are stricly speaking
> Bert> kist informative. But to not complicate matters to much, it
> Bert> doesn't harm to include them always in the normative set I
> Bert> think.
> 
> Looks like a good, short, concise boiler-plate.  I agree we should
> shorten it.
> 
> However, I do have one misgivings about it: If I were picking it up
> from the viewpoint of someone who didn't know about SNMP and MIBs at
> all [probably because it was a WG document for some other group], it's
> likely that I would not quite get the point that a MIB was tied to a
> protocol which can access it.  IE, I'd insert a line just before "This
> memo specifies" that says something like "MIBs are generally accessed
> through the Simple Network Management Protocol (SNMP)".
> 
> (yes I know that the first paragraph specifies the 2570 document, but
> I think it's important to mention the protocol directly in the text
> without having to visit the other document)
> 
> -- 
> "The trouble with having an open mind, of course, is that people will
>  insist on coming along and trying to put things in it."   -- 
> Terry Pratchett
>