X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=ofproto%2Fofproto.h;h=ed8d45b3f11fa69b3581492a8d71f9037264feb0;hb=abe529af477b8311a1fd68c130374bd7442003c3;hp=a94c8b59b303dc2214c9823beb0a80c67b9f4159;hpb=a4af00400a835eb87569ba40e21874c05e872c0f;p=sliver-openvswitch.git diff --git a/ofproto/ofproto.h b/ofproto/ofproto.h index a94c8b59b..ed8d45b3f 100644 --- a/ofproto/ofproto.h +++ b/ofproto/ofproto.h @@ -1,5 +1,5 @@ /* - * Copyright (c) 2009, 2010 Nicira Networks. + * Copyright (c) 2009, 2010, 2011 Nicira Networks. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -17,32 +17,45 @@ #ifndef OFPROTO_H #define OFPROTO_H 1 +#include +#include #include #include #include #include "flow.h" #include "netflow.h" +#include "sset.h" #include "tag.h" -struct odp_actions; -struct ofhooks; +#ifdef __cplusplus +extern "C" { +#endif + +struct cfm; +struct cls_rule; +struct netdev; struct ofproto; -struct svec; +struct shash; -enum { - DP_GROUP_FLOOD = 0, - DP_GROUP_ALL = 1 +struct ofproto_controller_info { + bool is_connected; + enum nx_role role; + struct { + const char *keys[4]; + const char *values[4]; + size_t n; + } pairs; }; struct ofexpired { - flow_t flow; + struct flow flow; uint64_t packet_count; /* Packets from subrules. */ uint64_t byte_count; /* Bytes from subrules. */ long long int used; /* Last-used time (0 if never used). */ }; struct ofproto_sflow_options { - struct svec targets; + struct sset targets; uint32_t sampling_rate; uint32_t polling_interval; uint32_t header_len; @@ -51,73 +64,178 @@ struct ofproto_sflow_options { char *control_ip; }; +/* How the switch should act if the controller cannot be contacted. */ +enum ofproto_fail_mode { + OFPROTO_FAIL_SECURE, /* Preserve flow table. */ + OFPROTO_FAIL_STANDALONE /* Act as a standalone switch. */ +}; + +enum ofproto_band { + OFPROTO_IN_BAND, /* In-band connection to controller. */ + OFPROTO_OUT_OF_BAND /* Out-of-band connection to controller. */ +}; + +struct ofproto_controller { + char *target; /* e.g. "tcp:127.0.0.1" */ + int max_backoff; /* Maximum reconnection backoff, in seconds. */ + int probe_interval; /* Max idle time before probing, in seconds. */ + enum ofproto_band band; /* In-band or out-of-band? */ + + /* OpenFlow packet-in rate-limiting. */ + int rate_limit; /* Max packet-in rate in packets per second. */ + int burst_limit; /* Limit on accumulating packet credits. */ +}; + +#define DEFAULT_MFR_DESC "Nicira Networks, Inc." +#define DEFAULT_HW_DESC "Open vSwitch" +#define DEFAULT_SW_DESC VERSION BUILDNR +#define DEFAULT_SERIAL_DESC "None" +#define DEFAULT_DP_DESC "None" + +void ofproto_enumerate_types(struct sset *types); +const char *ofproto_normalize_type(const char *); + +int ofproto_enumerate_names(const char *type, struct sset *names); +void ofproto_parse_name(const char *name, char **dp_name, char **dp_type); + int ofproto_create(const char *datapath, const char *datapath_type, - const struct ofhooks *, void *aux, struct ofproto **ofprotop); void ofproto_destroy(struct ofproto *); +int ofproto_delete(const char *name, const char *type); + int ofproto_run(struct ofproto *); -int ofproto_run1(struct ofproto *); -int ofproto_run2(struct ofproto *, bool revalidate_all); void ofproto_wait(struct ofproto *); bool ofproto_is_alive(const struct ofproto *); -/* Configuration. */ +/* A port within an OpenFlow switch. + * + * 'name' and 'type' are suitable for passing to netdev_open(). */ +struct ofproto_port { + char *name; /* Network device name, e.g. "eth0". */ + char *type; /* Network device type, e.g. "system". */ + uint16_t ofp_port; /* OpenFlow port number. */ +}; +void ofproto_port_clone(struct ofproto_port *, const struct ofproto_port *); +void ofproto_port_destroy(struct ofproto_port *); + +struct ofproto_port_dump { + const struct ofproto *ofproto; + int error; + void *state; +}; +void ofproto_port_dump_start(struct ofproto_port_dump *, + const struct ofproto *); +bool ofproto_port_dump_next(struct ofproto_port_dump *, struct ofproto_port *); +int ofproto_port_dump_done(struct ofproto_port_dump *); + +/* Iterates through each OFPROTO_PORT in OFPROTO, using DUMP as state. + * + * Arguments all have pointer type. + * + * If you break out of the loop, then you need to free the dump structure by + * hand using ofproto_port_dump_done(). */ +#define OFPROTO_PORT_FOR_EACH(OFPROTO_PORT, DUMP, OFPROTO) \ + for (ofproto_port_dump_start(DUMP, OFPROTO); \ + (ofproto_port_dump_next(DUMP, OFPROTO_PORT) \ + ? true \ + : (ofproto_port_dump_done(DUMP), false)); \ + ) + +int ofproto_port_add(struct ofproto *, struct netdev *, uint16_t *ofp_portp); +int ofproto_port_del(struct ofproto *, uint16_t ofp_port); + +int ofproto_port_query_by_name(const struct ofproto *, const char *devname, + struct ofproto_port *); + +/* Top-level configuration. */ void ofproto_set_datapath_id(struct ofproto *, uint64_t datapath_id); -void ofproto_set_probe_interval(struct ofproto *, int probe_interval); -void ofproto_set_max_backoff(struct ofproto *, int max_backoff); +void ofproto_set_controllers(struct ofproto *, + const struct ofproto_controller *, size_t n); +void ofproto_set_fail_mode(struct ofproto *, enum ofproto_fail_mode fail_mode); +void ofproto_reconnect_controllers(struct ofproto *); +void ofproto_set_extra_in_band_remotes(struct ofproto *, + const struct sockaddr_in *, size_t n); +void ofproto_set_in_band_queue(struct ofproto *, int queue_id); void ofproto_set_desc(struct ofproto *, - const char *manufacturer, const char *hardware, - const char *software, const char *serial); -int ofproto_set_in_band(struct ofproto *, bool in_band); -int ofproto_set_discovery(struct ofproto *, bool discovery, - const char *accept_controller_re, - bool update_resolv_conf); -int ofproto_set_controller(struct ofproto *, const char *controller); -int ofproto_set_listeners(struct ofproto *, const struct svec *listeners); -int ofproto_set_snoops(struct ofproto *, const struct svec *snoops); + const char *mfr_desc, const char *hw_desc, + const char *sw_desc, const char *serial_desc, + const char *dp_desc); +int ofproto_set_snoops(struct ofproto *, const struct sset *snoops); int ofproto_set_netflow(struct ofproto *, const struct netflow_options *nf_options); -void ofproto_set_sflow(struct ofproto *, const struct ofproto_sflow_options *); -void ofproto_set_failure(struct ofproto *, bool fail_open); -void ofproto_set_rate_limit(struct ofproto *, int rate_limit, int burst_limit); -int ofproto_set_stp(struct ofproto *, bool enable_stp); +int ofproto_set_sflow(struct ofproto *, const struct ofproto_sflow_options *); + +/* Configuration of ports. */ + +void ofproto_port_unregister(struct ofproto *, uint16_t ofp_port); + +void ofproto_port_clear_cfm(struct ofproto *, uint16_t ofp_port); +void ofproto_port_set_cfm(struct ofproto *, uint16_t ofp_port, + const struct cfm *, + const uint16_t *remote_mps, size_t n_remote_mps); +const struct cfm *ofproto_port_get_cfm(struct ofproto *, uint16_t ofp_port); +int ofproto_port_is_lacp_current(struct ofproto *, uint16_t ofp_port); + +/* Configuration of bundles. */ +struct ofproto_bundle_settings { + char *name; /* For use in log messages. */ + + uint16_t *slaves; /* OpenFlow port numbers for slaves. */ + size_t n_slaves; + + int vlan; /* VLAN if access port, -1 if trunk port. */ + unsigned long *trunks; /* vlan_bitmap, NULL to trunk all VLANs. */ + + struct bond_settings *bond; /* Must be nonnull iff if n_slaves > 1. */ + + struct lacp_settings *lacp; /* Nonnull to enable LACP. */ + struct lacp_slave_settings *lacp_slaves; /* Array of n_slaves elements. */ +}; + +int ofproto_bundle_register(struct ofproto *, void *aux, + const struct ofproto_bundle_settings *); +int ofproto_bundle_unregister(struct ofproto *, void *aux); + +/* Configuration of mirrors. */ +struct ofproto_mirror_settings { + /* Name for log messages. */ + char *name; + + /* Bundles that select packets for mirroring upon ingress. */ + void **srcs; /* A set of registered ofbundle handles. */ + size_t n_srcs; + + /* Bundles that select packets for mirroring upon egress. */ + void **dsts; /* A set of registered ofbundle handles. */ + size_t n_dsts; + + /* VLANs of packets to select for mirroring. */ + unsigned long *src_vlans; /* vlan_bitmap, NULL selects all VLANs. */ + + /* Output (mutually exclusive). */ + void *out_bundle; /* A registered ofbundle handle or NULL. */ + uint16_t out_vlan; /* Output VLAN, only if out_bundle is NULL. */ +}; + +int ofproto_mirror_register(struct ofproto *, void *aux, + const struct ofproto_mirror_settings *); +int ofproto_mirror_unregister(struct ofproto *, void *aux); + +int ofproto_set_flood_vlans(struct ofproto *, unsigned long *flood_vlans); +bool ofproto_is_mirror_output_bundle(struct ofproto *, void *aux); /* Configuration querying. */ -uint64_t ofproto_get_datapath_id(const struct ofproto *); -int ofproto_get_probe_interval(const struct ofproto *); -int ofproto_get_max_backoff(const struct ofproto *); -bool ofproto_get_in_band(const struct ofproto *); -bool ofproto_get_discovery(const struct ofproto *); -const char *ofproto_get_controller(const struct ofproto *); -void ofproto_get_listeners(const struct ofproto *, struct svec *); -void ofproto_get_snoops(const struct ofproto *, struct svec *); +bool ofproto_has_snoops(const struct ofproto *); +void ofproto_get_snoops(const struct ofproto *, struct sset *); void ofproto_get_all_flows(struct ofproto *p, struct ds *); +void ofproto_get_netflow_ids(const struct ofproto *, + uint8_t *engine_type, uint8_t *engine_id); -/* Functions for use by ofproto implementation modules, not by clients. */ -int ofproto_send_packet(struct ofproto *, const flow_t *, - const union ofp_action *, size_t n_actions, - const struct ofpbuf *); -void ofproto_add_flow(struct ofproto *, const flow_t *, uint32_t wildcards, - unsigned int priority, - const union ofp_action *, size_t n_actions, - int idle_timeout); -void ofproto_delete_flow(struct ofproto *, const flow_t *, uint32_t wildcards, - unsigned int priority); -void ofproto_flush_flows(struct ofproto *); - -/* Hooks for ovs-vswitchd. */ -struct ofhooks { - void (*port_changed_cb)(enum ofp_port_reason, const struct ofp_phy_port *, - void *aux); - bool (*normal_cb)(const flow_t *, const struct ofpbuf *packet, - struct odp_actions *, tag_type *, - uint16_t *nf_output_iface, void *aux); - void (*account_flow_cb)(const flow_t *, const union odp_action *, - size_t n_actions, unsigned long long int n_bytes, - void *aux); - void (*account_checkpoint_cb)(void *aux); -}; -void ofproto_revalidate(struct ofproto *, tag_type); -struct tag_set *ofproto_get_revalidate_set(struct ofproto *); +void ofproto_get_ofproto_controller_info(const struct ofproto *, struct shash *); +void ofproto_free_ofproto_controller_info(struct shash *); + +#ifdef __cplusplus +} +#endif #endif /* ofproto.h */