lib: check for integer-overflow in nlmsg_reserve()
[platform/upstream/libnl3.git] / man / genl-ctrl-list.8
1 .TH genl\-ctrl-list 8 "20 April 2012" "libnl"
2 .SH NAME
3 genl\-ctrl\-list \- List available kernel-side Generic Netlink families
4 .SH SYNOPSIS
5 .B genl\-ctrl\-list [-d]
6
7 .SH DESCRIPTION
8 .PP
9 Queries the Generic Netlink controller in kernel and prints a list of all
10 registered Generic Netlink families including the version of the interface
11 that has been registered.
12
13 .SH OPTIONS
14 .TP
15 .BR \-\^h " or " \-\-help
16 Print help text to console and exit.
17 .TP
18 .BR \-\^v " or " \-\-version
19 Print versioning information to console and exit.
20 .TP
21 .BR \-\^d " or " \-\-details
22 Include additional detailed information for each Generic Netlink
23 family that is printed.
24
25 The information includes:
26
27 .RS
28 .TP
29 .B hdrsize N
30 The size of the user specific header.
31
32 .TP
33 .B maxattr N
34 The maximum Netlink attribute identifier expected by the interface.
35
36 .TP
37 .B op NAME (ID) <FLAGS>
38 A list of available operations including their name, numeric identifier
39 and the flags indicating the capabilities of the opertion.
40
41 Available flags:
42 .RS
43 .TP
44 .I admin-perm
45 Requires administrative privileges
46
47 .TP
48 .I has-doit
49 Command can handle request
50
51 .TP
52 .I has-dump
53 Command can handle a dump request
54
55 .TP
56 .I has-policy
57 Command enforces attribute validation policy
58 .RE
59
60 .TP
61 .B grp NAME (ID)
62 A list of registered multicast groups including name (if available)
63 and identifier.
64 .RE
65
66 .RS
67 .B Example:
68 .RS
69 0x0010 nlctrl version 2
70 .RS 0
71     hdrsize 0 maxattr 7
72 .RS 0
73       op GETFAMILY (0x03) <has-doit,has-dump,has-policy>
74 .RS 0
75       grp notify (0x10)
76 .RE
77
78
79 .SH EXAMPLE
80 .RS 0
81 $ genl-ctrl-list 
82 .RS 0
83 0x0010 nlctrl version 2
84 .RS 0
85 0x0011 NLBL_MGMT version 3
86 .RS 0
87 0x0012 NLBL_CIPSOv4 version 3
88 .RS 0
89 0x0013 NLBL_UNLBL version 3
90 .RS 0
91 0x0014 acpi_event version 1
92 .RS 0
93 0x0015 thermal_event version 1
94 .RS 0
95 0x0016 VFS_DQUOT version 1
96 .RS 0
97 0x0017 TASKSTATS version 1
98 .RS 0
99 0x0018 NET_DM version 2
100
101 .SH AUTHOR
102 .PP
103 Thomas Graf is the original author and current maintainer of libnl and
104 libnl tools. Many people have contributed to it since.