summaryrefslogtreecommitdiff
path: root/man/genl-ctrl-list.8
blob: 613247546b7aba9812bc955ad6b03c488d8f8a8b (plain)
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
.TH genl\-ctrl-list 8 "20 April 2012" "libnl"
.SH NAME
genl\-ctrl\-list \- List available kernel-side Generic Netlink families
.SH SYNOPSIS
.B genl\-ctrl\-list [-d]

.SH DESCRIPTION
.PP
Queries the Generic Netlink controller in kernel and prints a list of all
registered Generic Netlink families including the version of the interface
that has been registered.

.SH OPTIONS
.TP
.BR \-\^h " or " \-\-help
Print help text to console and exit.
.TP
.BR \-\^v " or " \-\-version
Print versioning information to console and exit.
.TP
.BR \-\^d " or " \-\-details
Include additional detailed information for each Generic Netlink
family that is printed.

The information includes:

.RS
.TP
.B hdrsize N
The size of the user specific header.

.TP
.B maxattr N
The maximum Netlink attribute identifier expected by the interface.

.TP
.B op NAME (ID) <FLAGS>
A list of available operations including their name, numeric identifier
and the flags indicating the capabilities of the opertion.

Available flags:
.RS
.TP
.I admin-perm
Requires administrative privileges

.TP
.I has-doit
Command can handle request

.TP
.I has-dump
Command can handle a dump request

.TP
.I has-policy
Command enforces attribute validation policy
.RE

.TP
.B grp NAME (ID)
A list of registered multicast groups including name (if available)
and identifier.
.RE

.RS
.B Example:
.RS
0x0010 nlctrl version 2
.RS 0
    hdrsize 0 maxattr 7
.RS 0
      op GETFAMILY (0x03) <has-doit,has-dump,has-policy>
.RS 0
      grp notify (0x10)
.RE


.SH EXAMPLE
.RS 0
$ genl-ctrl-list 
.RS 0
0x0010 nlctrl version 2
.RS 0
0x0011 NLBL_MGMT version 3
.RS 0
0x0012 NLBL_CIPSOv4 version 3
.RS 0
0x0013 NLBL_UNLBL version 3
.RS 0
0x0014 acpi_event version 1
.RS 0
0x0015 thermal_event version 1
.RS 0
0x0016 VFS_DQUOT version 1
.RS 0
0x0017 TASKSTATS version 1
.RS 0
0x0018 NET_DM version 2

.SH AUTHOR
.PP
Thomas Graf is the original author and current maintainer of libnl and
libnl tools. Many people have contributed to it since.