2 * swlib.h: Switch configuration API (user space part)
4 * Copyright (C) 2008-2009 Felix Fietkau <nbd@nbd.name>
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public License
8 * version 2.1 as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
16 Usage of the library functions:
18 The main datastructure for a switch is the struct switch_device
19 To get started, you first need to use switch_connect() to probe
20 for switches and allocate an instance of this struct.
22 There are two possible usage modes:
23 dev = switch_connect("eth0");
24 - this call will look for a switch registered for the linux device
25 "eth0" and only allocate a switch_device for this particular switch.
27 dev = switch_connect(NULL)
28 - this will return one switch_device struct for each available
29 switch. The switch_device structs are chained with by ->next pointer
31 Then to query a switch for all available attributes, use:
34 All allocated datastructures for the switch_device struct can be freed with
39 The latter traverses a whole chain of switch_device structs and frees them all
41 Switch attributes (struct switch_attr) are divided into three groups:
49 switch_lookup_attr() is a small helper function to locate attributes
52 switch_set_attr() and switch_get_attr() can alter or request the values
55 Usage of the switch_attr struct:
57 ->atype: attribute group, one of:
58 - SWLIB_ATTR_GROUP_GLOBAL
59 - SWLIB_ATTR_GROUP_VLAN
60 - SWLIB_ATTR_GROUP_PORT
62 ->id: identifier for the attribute
64 ->type: data type, one of:
69 ->name: short name of the attribute
70 ->description: longer description
71 ->next: pointer to the next attribute of the current group
74 Usage of the switch_val struct:
76 When setting attributes, following members of the struct switch_val need
79 ->len (for attr->type == SWITCH_TYPE_PORT)
81 - port number (for attr->atype == SWLIB_ATTR_GROUP_PORT), or:
82 - vlan number (for attr->atype == SWLIB_ATTR_GROUP_VLAN)
83 ->value.i (for attr->type == SWITCH_TYPE_INT)
84 ->value.s (for attr->type == SWITCH_TYPE_STRING)
85 - owned by the caller, not stored in the library internally
86 ->value.ports (for attr->type == SWITCH_TYPE_PORT)
87 - must point to an array of at lest val->len * sizeof(struct switch_port)
89 When getting string attributes, val->value.s must be freed by the caller
90 When getting port list attributes, an internal static buffer is used,
91 which changes from call to call.
98 enum swlib_attr_group
{
99 SWLIB_ATTR_GROUP_GLOBAL
,
100 SWLIB_ATTR_GROUP_VLAN
,
101 SWLIB_ATTR_GROUP_PORT
,
104 enum swlib_port_flags
{
105 SWLIB_PORT_FLAG_TAGGED
= (1 << 0),
108 enum swlib_link_flags
{
109 SWLIB_LINK_FLAG_EEE_100BASET
= (1 << 0),
110 SWLIB_LINK_FLAG_EEE_1000BASET
= (1 << 1),
116 struct switch_port_map
;
117 struct switch_port_link
;
123 char dev_name
[IFNAMSIZ
];
129 struct switch_attr
*ops
;
130 struct switch_attr
*port_ops
;
131 struct switch_attr
*vlan_ops
;
132 struct switch_dev
*next
;
137 struct switch_attr
*attr
;
144 struct switch_port
*ports
;
145 struct switch_port_link
*link
;
150 struct switch_dev
*dev
;
156 struct switch_attr
*next
;
164 struct switch_port_link
{
171 /* in ethtool adv_t format */
176 * swlib_list: list all switches
178 void swlib_list(void);
181 * swlib_connect: connect to the switch through netlink
182 * @name: name of the ethernet interface,
184 * if name is NULL, it connect and builds a chain of all switches
186 struct switch_dev
*swlib_connect(const char *name
);
189 * swlib_free: free all dynamically allocated data for the switch connection
190 * @dev: switch device struct
192 * all members of a switch device chain (generated by swlib_connect(NULL))
193 * must be freed individually
195 void swlib_free(struct switch_dev
*dev
);
198 * swlib_free_all: run swlib_free on all devices in the chain
199 * @dev: switch device struct
201 void swlib_free_all(struct switch_dev
*dev
);
204 * swlib_scan: probe the switch driver for available commands/attributes
205 * @dev: switch device struct
207 int swlib_scan(struct switch_dev
*dev
);
210 * swlib_lookup_attr: look up a switch attribute
211 * @dev: switch device struct
212 * @type: global, port or vlan
213 * @name: name of the attribute
215 struct switch_attr
*swlib_lookup_attr(struct switch_dev
*dev
,
216 enum swlib_attr_group atype
, const char *name
);
219 * swlib_set_attr: set the value for an attribute
220 * @dev: switch device struct
221 * @attr: switch attribute struct
222 * @val: attribute value pointer
223 * returns 0 on success
225 int swlib_set_attr(struct switch_dev
*dev
, struct switch_attr
*attr
,
226 struct switch_val
*val
);
229 * swlib_set_attr_string: set the value for an attribute with type conversion
230 * @dev: switch device struct
231 * @attr: switch attribute struct
232 * @port_vlan: port or vlan (if applicable)
234 * returns 0 on success
236 int swlib_set_attr_string(struct switch_dev
*dev
, struct switch_attr
*attr
,
237 int port_vlan
, const char *str
);
240 * swlib_get_attr: get the value for an attribute
241 * @dev: switch device struct
242 * @attr: switch attribute struct
243 * @val: attribute value pointer
244 * returns 0 on success
245 * for string attributes, the result string must be freed by the caller
247 int swlib_get_attr(struct switch_dev
*dev
, struct switch_attr
*attr
,
248 struct switch_val
*val
);
251 * swlib_apply_from_uci: set up the switch from a uci configuration
252 * @dev: switch device struct
253 * @p: uci package which contains the desired global config
255 int swlib_apply_from_uci(struct switch_dev
*dev
, struct uci_package
*p
);