Repository navigation
Expand file tree
/
Copy pathrmib.h
More file actions
152 lines (140 loc) · 5.49 KB
/
Copy pathrmib.h
File metadata and controls
152 lines (140 loc) · 5.49 KB
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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
#ifndef _MINIX_RMIB_H
#define _MINIX_RMIB_H
/*
* This header file is for use by services that use the remote MIB (RMIB)
* functionality of libsys. RMIB allows services to mount and handle certain
* subtrees of the MIB service's sysctl tree.
*/
#include <sys/sysctl.h>
/*
* This structure contains a number of less heavily used parameters for handler
* functions, mainly to provide extensibility while limiting argument clutter.
*/
struct rmib_call {
endpoint_t call_endpt; /* endpoint of the user process */
const int *call_name; /* remaining part of the name */
unsigned int call_namelen; /* length of the remaining name part */
unsigned int call_flags; /* RMIB_FLAG_ call flags */
uint32_t call_rootver; /* version of all nodes in subtree */
uint32_t call_treever; /* version of the entire MIB tree */
};
/*
* Call flags.
*
* TODO: this is effectively a flag used on the wire. This should be turned
* into a proper definition shared with the MIB service. As long as we have
* only one flag anyway, this is not exactly urgent though.
*/
#define RMIB_FLAG_AUTH 0x1 /* user has superuser privileges */
struct rmib_node;
struct rmib_oldp;
struct rmib_newp;
typedef ssize_t (*rmib_func_ptr)(struct rmib_call *, struct rmib_node *,
struct rmib_oldp *, struct rmib_newp *);
/*
* The central structure for remote MIB nodes. This is essentially a somewhat
* cut-down version of the node structure used within the MIB service. See the
* source code of that service for several details that apply here as well.
* The 'rnode_' prefix makes it possible to include both this header file and
* the MIB service's internal header file at once--neat if useless.
*/
struct rmib_node {
uint32_t rnode_flags; /* CTLTYPE_ type and CTLFLAG_ flags */
size_t rnode_size; /* size of associated data */
union ixfer_rnode_val_u {
bool rvu_bool; /* immediate boolean */
int rvu_int; /* immediate integer */
u_quad_t rvu_quad; /* immediate quad */
uint32_t rvu_clen; /* number of actual children */
} rnode_val_u;
union pxfer_rnode_ptr_u {
void *rpu_data; /* struct or string data pointer */
struct rmib_node *rpu_cptr; /* child node array */
} rnode_ptr_u;
rmib_func_ptr rnode_func; /* handler function */
const char *rnode_name; /* node name string */
const char *rnode_desc; /* node description (may be NULL) */
};
#define rnode_bool rnode_val_u.rvu_bool
#define rnode_int rnode_val_u.rvu_int
#define rnode_quad rnode_val_u.rvu_quad
#define rnode_clen rnode_val_u.rvu_clen
#define rnode_data rnode_ptr_u.rpu_data
#define rnode_cptr rnode_ptr_u.rpu_cptr
/* Various macros to initialize nodes at compile time. */
#define RMIB_NODE(f,t,n,d) { \
.rnode_flags = CTLTYPE_NODE | CTLFLAG_READONLY | \
CTLFLAG_PERMANENT | f, \
.rnode_size = __arraycount(t), \
.rnode_cptr = t, \
.rnode_name = n, \
.rnode_desc = d \
}
#define RMIB_FUNC(f,s,fp,n,d) { \
.rnode_flags = CTLFLAG_PERMANENT | f, \
.rnode_size = s, \
.rnode_func = fp, \
.rnode_name = n, \
.rnode_desc = d \
}
#define RMIB_BOOL(f,b,n,d) { \
.rnode_flags = CTLTYPE_BOOL | CTLFLAG_PERMANENT | \
CTLFLAG_IMMEDIATE | f, \
.rnode_size = sizeof(bool), \
.rnode_bool = b, \
.rnode_name = n, \
.rnode_desc = d \
}
#define RMIB_INT(f,i,n,d) { \
.rnode_flags = CTLTYPE_INT | CTLFLAG_PERMANENT | \
CTLFLAG_IMMEDIATE | f, \
.rnode_size = sizeof(int), \
.rnode_int = i, \
.rnode_name = n, \
.rnode_desc = d \
}
#define RMIB_QUAD(f,q,n,d) { \
.rnode_flags = CTLTYPE_QUAD | CTLFLAG_PERMANENT | \
CTLFLAG_IMMEDIATE | f, \
.rnode_size = sizeof(u_quad_t), \
.rnode_quad = q, \
.rnode_name = n, \
.rnode_desc = d \
}
#define _RMIB_DATA(f,s,p,n,d) { \
.rnode_flags = CTLFLAG_PERMANENT | f, \
.rnode_size = s, \
.rnode_data = __UNCONST(p), \
.rnode_name = n, \
.rnode_desc = d \
}
/*
* The following macros really require a pointer to the proper data type; weird
* casts may not trigger compiler warnings but do allow for memory corruption.
* The first three need to be passed a pointer to a bool, int, and u_quad_t,
* respectively. RMIB_STRING needs a pointer to a character array, so that
* sizeof(array) yields the proper size. Since RMIB_STRUCT may be given a
* pointer to either a structure or an array, it must also be given a size.
*/
#define RMIB_BOOLPTR(f,p,n,d) _RMIB_DATA(CTLTYPE_BOOL | f, sizeof(*p), p, n, d)
#define RMIB_INTPTR(f,p,n,d) _RMIB_DATA(CTLTYPE_INT | f, sizeof(*p), p, n, d)
#define RMIB_QUADPTR(f,p,n,d) _RMIB_DATA(CTLTYPE_QUAD | f, sizeof(*p), p, n, d)
#define RMIB_STRING(f,p,n,d) \
_RMIB_DATA(CTLTYPE_STRING | f, sizeof(p), p, n, d)
#define RMIB_STRUCT(f,s,p,n,d) _RMIB_DATA(CTLTYPE_STRUCT | f, s, p, n, d)
/* Shortcut flag macros. */
#define RMIB_RO CTLFLAG_READONLY /* shortcut for read-only nodes */
#define RMIB_RW CTLFLAG_READWRITE /* shortcut for read-write nodes */
/* Function prototypes. */
int rmib_register(const int * name, unsigned int namelen, struct rmib_node *);
int rmib_deregister(struct rmib_node *);
void rmib_reset(void);
void rmib_process(const message *, int);
int rmib_inrange(struct rmib_oldp *, size_t);
size_t rmib_getoldlen(struct rmib_oldp *);
ssize_t rmib_copyout(struct rmib_oldp *, size_t, const void * __restrict,
size_t);
int rmib_copyin(struct rmib_newp * __restrict, void * __restrict, size_t);
ssize_t rmib_readwrite(struct rmib_call *, struct rmib_node *,
struct rmib_oldp *, struct rmib_newp *);
#endif /* !_MINIX_RMIB_H */