~ubuntu-branches/debian/lenny/net-snmp/lenny

« back to all changes in this revision

Viewing changes to man/netsnmp_snmp_agent.3

  • Committer: Bazaar Package Importer
  • Author(s): Steve Kowalik
  • Date: 2007-05-10 22:20:23 UTC
  • Revision ID: james.westby@ubuntu.com-20070510222023-3fr07xb9i17xvq32
Tags: upstream-5.3.1
ImportĀ upstreamĀ versionĀ 5.3.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH "net-snmp agent related processing" 3 "14 Jul 2006" "Version 5.2.3" "net-snmp" \" -*- nroff -*-
 
1
.TH "net-snmp agent related processing" 3 "13 Jul 2006" "Version 5.3.1" "net-snmp" \" -*- nroff -*-
2
2
.ad l
3
3
.nh
4
4
.SH NAME
189
189
.RI "void \fBnetsnmp_delete_subtree_cache\fP (\fBnetsnmp_agent_session\fP *asp)"
190
190
.br
191
191
.ti -1c
 
192
.RI "int \fBnetsnmp_check_all_requests_error\fP (\fBnetsnmp_agent_session\fP *asp, int look_for_specific)"
 
193
.br
 
194
.ti -1c
192
195
.RI "int \fBnetsnmp_check_requests_error\fP (\fBnetsnmp_request_info\fP *requests)"
193
196
.br
194
197
.ti -1c
279
282
.RI "int \fBlog_addresses\fP = 0"
280
283
.br
281
284
.ti -1c
282
 
.RI "int \fBnetsnmp_running\fP = 1"
283
 
.br
284
 
.ti -1c
285
285
.RI "\fBnetsnmp_agent_session\fP * \fBagent_delegated_list\fP = NULL"
286
286
.br
287
287
.ti -1c
288
288
.RI "\fBnetsnmp_agent_session\fP * \fBnetsnmp_agent_queued_list\fP = NULL"
289
289
.br
290
290
.ti -1c
 
291
.RI "int \fBnetsnmp_running\fP = 1"
 
292
.br
 
293
.ti -1c
291
294
.RI "\fBnetsnmp_session\fP * \fBmain_session\fP = NULL"
292
295
.br
293
296
.ti -1c
300
303
.PP
301
304
set error for a request 
302
305
.PP
303
 
Definition at line 3276 of file snmp_agent.c.
 
306
Definition at line 3322 of file snmp_agent.c.
304
307
.PP
305
308
References netsnmp_request_info_s::delegated, netsnmp_request_info_s::processed, REQUEST_IS_NOT_DELEGATED, netsnmp_request_info_s::requestvb, snmp_log(), netsnmp_request_info_s::status, and variable_list::type.
306
309
.PP
323
326
.PP
324
327
 
325
328
.PP
326
 
Definition at line 562 of file snmp_agent.c.
 
329
Definition at line 560 of file snmp_agent.c.
327
330
.PP
328
331
References FD_ZERO, netsnmp_check_outstanding_agent_requests(), NULL, run_alarms(), snmp_log(), snmp_log_perror(), snmp_read(), snmp_select_info(), and snmp_timeout().
329
332
.SS "int check_getnext_results (\fBnetsnmp_agent_session\fP * asp)"
332
335
.PP
333
336
Returns 0 if not. 
334
337
.PP
335
 
Definition at line 2692 of file snmp_agent.c.
 
338
Definition at line 2735 of file snmp_agent.c.
336
339
.PP
337
340
References netsnmp_request_info_s::inclusive, netsnmp_request_info_s::index, netsnmp_agent_session_s::mode, netsnmp_request_info_s::next, NULL, netsnmp_agent_session_s::oldmode, netsnmp_request_info_s::requestvb, snmp_set_var_typed_value(), netsnmp_agent_session_s::treecache, and netsnmp_agent_session_s::treecache_num.
338
341
.PP
343
346
.PP
344
347
It's expected that one pass has been made before entering this function 
345
348
.PP
346
 
Definition at line 2797 of file snmp_agent.c.
 
349
Definition at line 2840 of file snmp_agent.c.
347
350
.PP
348
351
References check_acm(), check_getnext_results(), handle_var_requests(), netsnmp_check_for_delegated(), netsnmp_reassign_requests(), netsnmp_running, and variable_list::next_variable.
349
352
.PP
419
422
.PP
420
423
 
421
424
.PP
422
 
Definition at line 3091 of file snmp_agent.c.
 
425
Definition at line 3134 of file snmp_agent.c.
423
426
.PP
424
427
References check_acm(), snmp_pdu::command, count_varbinds(), snmp_pdu::flags, get_set_cache(), handle_getnext_loop(), handle_set_loop(), handle_var_requests(), netsnmp_agent_session_s::mode, netsnmp_create_subtree_cache(), variable_list::next_variable, NULL, netsnmp_agent_session_s::oldmode, netsnmp_agent_session_s::pdu, netsnmp_agent_session_s::requests, snmp_increment_statistic(), snmp_replace_var_types(), snmp_set_var_typed_value(), netsnmp_agent_session_s::status, variable_list::type, snmp_pdu::variables, and netsnmp_agent_session_s::vbcount.
425
428
.PP
428
431
.PP
429
432
handles an incoming SNMP packet into the agent 
430
433
.PP
431
 
Definition at line 1731 of file snmp_agent.c.
 
434
Definition at line 1735 of file snmp_agent.c.
432
435
.PP
433
436
References check_access(), snmp_pdu::command, snmp_pdu::errstat, init_agent_snmp_session(), netsnmp_handle_request(), netsnmp_remove_and_free_agent_snmp_session(), NULL, netsnmp_agent_session_s::pdu, snmp_session::s_snmp_errno, send_easy_trap(), netsnmp_agent_session_s::session, snmp_free_pdu(), snmp_increment_statistic(), snmp_send(), netsnmp_agent_session_s::status, and snmp_pdu::version.
434
437
.PP
442
445
.PP
443
446
 
444
447
.PP
445
 
Definition at line 1832 of file snmp_agent.c.
 
448
Definition at line 1844 of file snmp_agent.c.
446
449
.PP
447
450
References netsnmp_request_info_s::agent_req_info, netsnmp_agent_session_s::cache_store, netsnmp_subtree_s::cacheid, snmp_pdu::command, netsnmp_request_info_s::delegated, netsnmp_subtree_s::end_a, netsnmp_subtree_s::end_len, netsnmp_subtree_s::global_cacheid, netsnmp_request_info_s::inclusive, netsnmp_request_info_s::index, variable_list::name, variable_list::name_length, netsnmp_acm_check_subtree(), netsnmp_free_request_data_sets(), netsnmp_get_local_cachid(), netsnmp_get_or_add_local_cachid(), netsnmp_oid_find_prefix(), netsnmp_request_info_s::next, netsnmp_subtree_s::next, NULL, netsnmp_request_info_s::parent_data, netsnmp_agent_session_s::pdu, netsnmp_request_info_s::prev, netsnmp_request_info_s::processed, netsnmp_request_info_s::range_end, netsnmp_request_info_s::range_end_len, netsnmp_agent_session_s::reqinfo, netsnmp_agent_session_s::requests, netsnmp_tree_cache_s::requests_begin, netsnmp_tree_cache_s::requests_end, netsnmp_request_info_s::requestvb, netsnmp_request_info_s::requestvb_start, netsnmp_subtree_s::start_a, netsnmp_subtree_s::start_len, netsnmp_request_info_s::status, netsnmp_tree_cache_s::subtree, netsnmp_request_info_s::subtree, netsnmp_agent_session_s::treecache, netsnmp_agent_session_s::treecache_len, netsnmp_agent_session_s::treecache_num, and variable_list::type.
448
451
.SS "int netsnmp_check_transaction_id (int transaction_id)"
453
456
.PP
454
457
returns SNMPERR_SUCCESS if it's still valid, or SNMPERR_GENERR if not. 
455
458
.PP
456
 
Definition at line 2602 of file snmp_agent.c.
 
459
Definition at line 2645 of file snmp_agent.c.
457
460
.PP
458
461
References agent_delegated_list, netsnmp_agent_session_s::next, and NULL.
459
462
.PP
471
474
.PP
472
475
 
473
476
.PP
474
 
Definition at line 3344 of file snmp_agent.c.
 
477
Definition at line 3390 of file snmp_agent.c.
475
478
.PP
476
479
References _request_set_error(), netsnmp_request_info_s::agent_req_info, and netsnmp_agent_request_info_s::mode.
477
480
.PP
494
497
.PP
495
498
paranoid sanity checks 
496
499
.PP
497
 
Definition at line 3359 of file snmp_agent.c.
 
500
Definition at line 3405 of file snmp_agent.c.
498
501
.PP
499
502
References _request_set_error(), netsnmp_request_info_s::agent_req_info, netsnmp_agent_request_info_s::mode, netsnmp_request_info_s::next, NULL, and snmp_log().
500
503
.PP
501
 
Referenced by netsnmp_set_all_requests_error().
 
504
Referenced by netsnmp_cache_helper_handler(), netsnmp_multiplexer_helper_handler(), netsnmp_read_only_helper(), and netsnmp_set_all_requests_error().
502
505
.SS "int netsnmp_set_all_requests_error (\fBnetsnmp_agent_request_info\fP * reqinfo, \fBnetsnmp_request_info\fP * requests, int error_value)"
503
506
.PP
504
507
set error for all request 
524
527
.PP
525
528
 
526
529
.PP
527
 
Definition at line 3533 of file snmp_agent.c.
 
530
Definition at line 3579 of file snmp_agent.c.
528
531
.PP
529
532
References netsnmp_request_set_error_all().
530
 
.PP
531
 
Referenced by netsnmp_cache_helper_handler(), netsnmp_multiplexer_helper_handler(), and netsnmp_read_only_helper().
532
533
.SS "int netsnmp_set_mode_request_error (int mode, \fBnetsnmp_request_info\fP * request, int error_value)"
533
534
.PP
534
535
deprecated, use netsnmp_request_set_error instead 
554
555
.PP
555
556
 
556
557
.PP
557
 
Definition at line 3517 of file snmp_agent.c.
 
558
Definition at line 3563 of file snmp_agent.c.
558
559
.PP
559
560
References _request_set_error().
560
561
.SS "int netsnmp_set_request_error (\fBnetsnmp_agent_request_info\fP * reqinfo, \fBnetsnmp_request_info\fP * request, int error_value)"
586
587
.in +1c
587
588
\fBdelayed_instance.c\fP.
588
589
.PP
589
 
Definition at line 3498 of file snmp_agent.c.
 
590
Definition at line 3544 of file snmp_agent.c.
590
591
.PP
591
592
References _request_set_error(), and netsnmp_agent_request_info_s::mode.
592
593
.PP
593
 
Referenced by netsnmp_call_handlers(), netsnmp_instance_counter32_handler(), netsnmp_instance_helper_handler(), netsnmp_instance_int_handler(), netsnmp_instance_long_handler(), netsnmp_instance_ulong_handler(), netsnmp_scalar_group_helper_handler(), netsnmp_scalar_helper_handler(), netsnmp_table_data_set_helper_handler(), netsnmp_watched_timestamp_handler(), netsnmp_watcher_helper_handler(), and table_helper_handler().
 
594
Referenced by netsnmp_call_handlers(), netsnmp_instance_counter32_handler(), netsnmp_instance_helper_handler(), netsnmp_instance_int_handler(), netsnmp_instance_long_handler(), netsnmp_instance_num_file_handler(), netsnmp_instance_ulong_handler(), netsnmp_scalar_group_helper_handler(), netsnmp_scalar_helper_handler(), netsnmp_table_data_set_helper_handler(), netsnmp_watched_spinlock_handler(), netsnmp_watched_timestamp_handler(), netsnmp_watcher_helper_handler(), and table_helper_handler().
594
595
.SS "int netsnmp_wrap_up_request (\fBnetsnmp_agent_session\fP * asp, int status)"
595
596
.PP
596
597
if asp->pdu 
597
598
.PP
598
 
Definition at line 1482 of file snmp_agent.c.
 
599
Definition at line 1486 of file snmp_agent.c.
599
600
.PP
600
601
References _reorder_getbulk(), snmp_pdu::command, count_varbinds(), snmp_pdu::errindex, snmp_pdu::errstat, netsnmp_agent_session_s::index, variable_list::name, variable_list::name_length, netsnmp_remove_and_free_agent_snmp_session(), variable_list::next_variable, NULL, netsnmp_agent_session_s::orig_pdu, netsnmp_agent_session_s::pdu, save_set_cache(), netsnmp_agent_session_s::session, SNMP_FREE, snmp_free_pdu(), snmp_increment_statistic(), snmp_increment_statistic_by(), snmp_log(), snmp_perror(), snmp_send(), sprint_realloc_objid(), netsnmp_agent_session_s::status, variable_list::type, snmp_pdu::variables, and snmp_pdu::version.
601
602
.PP