~ubuntu-branches/ubuntu/intrepid/net-snmp/intrepid-updates

« back to all changes in this revision

Viewing changes to man/netsnmp_utilities.3

  • Committer: Bazaar Package Importer
  • Author(s): Scott James Remnant
  • Date: 2006-11-28 12:29:34 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20061128122934-82xxzy2zcvypnvy7
Tags: 5.2.3-4ubuntu1
* Merge from debian unstable, remaining changes:
  - remove stop links from rc0 and rc6

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH "utility_handlers: simplify request processing" 3 "28 Nov 2005" "Version 5.2.1.rc3" "net-snmp" \" -*- nroff -*-
 
1
.TH "utility_handlers" 3 "14 Jul 2006" "Version 5.2.3" "net-snmp" \" -*- nroff -*-
2
2
.ad l
3
3
.nh
4
4
.SH NAME
5
 
utility_handlers: simplify request processing \- A group of handlers intended to simplify certain aspects of processing a request for a MIB object.  
 
5
utility_handlers \- Simplify request processing A group of handlers intended to simplify certain aspects of processing a request for a MIB object.  
6
6
 
7
7
.PP
8
8
.SS "Modules"
9
9
 
10
10
.in +1c
11
11
.ti -1c
12
 
.RI "\fBbulk_to_next: convert GETBULK requests into GETNEXT requests for the handler.\fP"
13
 
.br
14
 
.RI "\fIThe only purpose of this handler is to convert a GETBULK request to a GETNEXT request. \fP"
15
 
.PP
16
 
.in +1c
17
 
 
18
 
.ti -1c
19
 
.RI "\fBcache_handler: Maintains a cache of data for use by lower level handlers.\fP"
20
 
.br
21
 
.RI "\fIThis helper checks to see whether the data has been loaded 'recently' (according to the timeout for that particular cache) and calls the registered 'load_cache' routine if necessary. \fP"
22
 
.PP
23
 
.in +1c
24
 
 
25
 
.ti -1c
26
 
.RI "\fBdebug: print out debugging information about the handler chain being called.\fP"
27
 
.br
28
 
.RI "\fIThis is a useful module for run-time debugging of requests as the pass this handler in a calling chain. \fP"
29
 
.PP
30
 
.in +1c
31
 
 
32
 
.ti -1c
33
 
.RI "\fBmode_end_call: at the end of a series of requests, call another handler hook.\fP"
34
 
.br
35
 
.RI "\fIHandlers that want to loop through a series of requests and then receive a callback at the end of a particular MODE can use this helper to make this possible. \fP"
36
 
.PP
37
 
.in +1c
38
 
 
39
 
.ti -1c
40
 
.RI "\fBmultiplexer: splits mode requests into calls to different handlers.\fP"
41
 
.br
42
 
.RI "\fIThe multiplexer helper lets you split the calling chain depending on the calling mode (get vs getnext vs set). \fP"
43
 
.PP
44
 
.in +1c
45
 
 
46
 
.ti -1c
47
 
.RI "\fBread_only: make your handler read_only automatically\fP"
48
 
.br
49
 
.RI "\fIThe only purpose of this handler is to return an appropriate error for any requests passed to it in a SET mode. \fP"
50
 
.PP
51
 
.in +1c
52
 
 
53
 
.ti -1c
54
 
.RI "\fBrow_merge: Calls sub handlers with request for one row at a time.\fP"
55
 
.br
56
 
.RI "\fIThis helper splits a whole bunch of requests into chunks based on the row index that they refer to, and passes all requests for a given row to the lower handlers. \fP"
57
 
.PP
58
 
.in +1c
59
 
 
60
 
.ti -1c
61
 
.RI "\fBserialize: Calls sub handlers one request at a time.\fP"
62
 
.br
63
 
.RI "\fIThis functionally passes in one request at a time into lower handlers rather than a whole bunch of requests at once. \fP"
 
12
.RI "\fBbulk_to_next\fP"
 
13
.br
 
14
.RI "\fIConvert GETBULK requests into GETNEXT requests for the handler. \fP"
 
15
.PP
 
16
.in +1c
 
17
 
 
18
.ti -1c
 
19
.RI "\fBcache_handler\fP"
 
20
.br
 
21
.RI "\fIMaintains a cache of data for use by lower level handlers. \fP"
 
22
.PP
 
23
.in +1c
 
24
 
 
25
.ti -1c
 
26
.RI "\fBdebug\fP"
 
27
.br
 
28
.RI "\fIPrint out debugging information about the handler chain being called. \fP"
 
29
.PP
 
30
.in +1c
 
31
 
 
32
.ti -1c
 
33
.RI "\fBmode_end_call\fP"
 
34
.br
 
35
.RI "\fIAt the end of a series of requests, call another handler hook. \fP"
 
36
.PP
 
37
.in +1c
 
38
 
 
39
.ti -1c
 
40
.RI "\fBmultiplexer\fP"
 
41
.br
 
42
.RI "\fISplits mode requests into calls to different handlers. \fP"
 
43
.PP
 
44
.in +1c
 
45
 
 
46
.ti -1c
 
47
.RI "\fBread_only\fP"
 
48
.br
 
49
.RI "\fIMake your handler read_only automatically The only purpose of this handler is to return an appropriate error for any requests passed to it in a SET mode. \fP"
 
50
.PP
 
51
.in +1c
 
52
 
 
53
.ti -1c
 
54
.RI "\fBrow_merge\fP"
 
55
.br
 
56
.RI "\fICalls sub handlers with request for one row at a time. \fP"
 
57
.PP
 
58
.in +1c
 
59
 
 
60
.ti -1c
 
61
.RI "\fBserialize\fP"
 
62
.br
 
63
.RI "\fICalls sub handlers one request at a time. \fP"
64
64
.PP
65
65
 
66
66
.in -1c
67
67
.SH "Detailed Description"
68
68
.PP 
69
 
A group of handlers intended to simplify certain aspects of processing a request for a MIB object. 
 
69
Simplify request processing A group of handlers intended to simplify certain aspects of processing a request for a MIB object. 
70
70
.PP
71
 
These helpers do not implement any MIB objects themselves. Rather they handle specific generic situations, either returning an error, or passing a (possibly simpler) request down to lower level handlers.
 
71
These helpers do not implement any MIB objects themselves. Rather they handle specific generic situations, either returning an error, or passing a (possibly simpler) request down to lower level handlers.