1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
.TH snmpa_network_interface 3 "snmp 4.11" "Ericsson AB" "ERLANG MODULE DEFINITION"
.SH MODULE
snmpa_network_interface \- Behaviour module for the SNMP agent network interface\&.
.SH DESCRIPTION
.LP
This module defines the behaviour of the agent network interface\&. A \fIsnmpa_network_interface\fR compliant module must export the following functions:
.RS 2
.TP 2
*
start_link/4
.TP 2
*
info/1
.TP 2
*
get_log_type/1
.TP 2
*
set_log_type/2
.TP 2
*
verbosity/2
.RE
.LP
The semantics of them and their exact signatures are explained below\&.
.LP
But this is not enough\&. There is also a set of \fImandatory\fR messages which the network interface entity must be able to receive and be able to send\&. This is described in chapter snmp_agent_netif\&.
.SH EXPORTS
.LP
.B
start_link(Prio, NoteStore, MasterAgent, Opts) -> {ok, Pid} | {error, Reason}
.br
.RS
.TP
Types
Prio = priority()
.br
NoteStore = pid()
.br
MasterAgent = pid()
.br
Opts = [opt()]
.br
opt() = {verbosity, verbosity()} | {versions, versions()} | term()
.br
versions() = [version()]
.br
version() = v1 | v2 | v3
.br
.RE
.RS
.LP
Start-link the network interface process\&.
.LP
\fINoteStore\fR is the pid of the note-store process and \fIMasterAgent\fR is the pid of the master-agent process\&.
.LP
\fIOpts\fR is an (basically) implementation dependent list of options to the network interface process\&. There are however a number of options which \fImust\fR be handled: \fIversions\fR and \fIverbosity\fR\&.
.RE
.LP
.B
info(Pid) -> [{Key, Value}]
.br
.RS
.TP
Types
Pid = pid()
.br
.RE
.RS
.LP
The info returned is basically up to the implementer to decide\&. This implementation provided by the application provides info about memory allocation and various socket information\&.
.LP
The info returned by this function is returned together with other info collected by the agent when the info function is called (tagged with with the key \fInet_if\fR)\&.
.RE
.LP
.B
verbosity(Pid, Verbosity) -> void()
.br
.RS
.TP
Types
Pid = pid()
.br
Verbosity = verbosity()
.br
.RE
.RS
.LP
Change the verbosity of a running network interface process\&.
.RE
.LP
.B
get_log_type(Pid) -> {ok, LogType} | {error, Reason}
.br
.RS
.TP
Types
Pid = pid()
.br
LogType = atl_type()
.br
Reason = term()
.br
.RE
.RS
.LP
The Audit Trail Log is managed by the network interface process\&. So, it is this process that has to retrieve the actual log-type\&.
.RE
.LP
.B
set_log_type(Pid, NewType) -> {ok, OldType} | {error, Reason}
.br
.RS
.TP
Types
Pid = pid()
.br
NewType = OldType = atl_type()
.br
Reason = term()
.br
.RE
.RS
.LP
The Audit Trail Log is managed by the network interface process\&. So, it is this process that has to do the actual changing of the type\&.
.LP
See set_log_type for more info\&.
.RE
|
