| /* |
| * General overview: |
| * full generic netlink message: |
| * |nlmsghdr|genlmsghdr|<payload> |
| * |
| * payload: |
| * |optional fixed size family header|<sequence of netlink attributes> |
| * |
| * sequence of netlink attributes: |
| * I chose to have all "top level" attributes NLA_NESTED, |
| * corresponding to some real struct. |
| * So we have a sequence of |tla, len|<nested nla sequence> |
| * |
| * nested nla sequence: |
| * may be empty, or contain a sequence of netlink attributes |
| * representing the struct fields. |
| * |
| * The tag number of any field (regardless of containing struct) |
| * will be available as T_ ## field_name, |
| * so you cannot have the same field name in two differnt structs. |
| * |
| * The tag numbers themselves are per struct, though, |
| * so should always begin at 1 (not 0, that is the special "NLA_UNSPEC" type, |
| * which we won't use here). |
| * The tag numbers are used as index in the respective nla_policy array. |
| * |
| * GENL_struct(tag_name, tag_number, struct name, struct fields) - struct and policy |
| * genl_magic_struct.h |
| * generates the struct declaration, |
| * generates an entry in the tla enum, |
| * genl_magic_func.h |
| * generates an entry in the static tla policy |
| * with .type = NLA_NESTED |
| * generates the static <struct_name>_nl_policy definition, |
| * and static conversion functions |
| * |
| * genl_magic_func.h |
| * |
| * GENL_mc_group(group) |
| * genl_magic_struct.h |
| * does nothing |
| * genl_magic_func.h |
| * defines and registers the mcast group, |
| * and provides a send helper |
| * |
| * GENL_notification(op_name, op_num, mcast_group, tla list) |
| * These are notifications to userspace. |
| * |
| * genl_magic_struct.h |
| * generates an entry in the genl_ops enum, |
| * genl_magic_func.h |
| * does nothing |
| * |
| * mcast group: the name of the mcast group this notification should be |
| * expected on |
| * tla list: the list of expected top level attributes, |
| * for documentation and sanity checking. |
| * |
| * GENL_op(op_name, op_num, flags and handler, tla list) - "genl operations" |
| * These are requests from userspace. |
| * |
| * _op and _notification share the same "number space", |
| * op_nr will be assigned to "genlmsghdr->cmd" |
| * |
| * genl_magic_struct.h |
| * generates an entry in the genl_ops enum, |
| * genl_magic_func.h |
| * generates an entry in the static genl_ops array, |
| * and static register/unregister functions to |
| * genl_register_family_with_ops(). |
| * |
| * flags and handler: |
| * GENL_op_init( .doit = x, .dumpit = y, .flags = something) |
| * GENL_doit(x) => .dumpit = NULL, .flags = GENL_ADMIN_PERM |
| * tla list: the list of expected top level attributes, |
| * for documentation and sanity checking. |
| */ |
| |
| /* |
| * STRUCTS |
| */ |
| |
| /* this is sent kernel -> userland on various error conditions, and contains |
| * informational textual info, which is supposedly human readable. |
| * The computer relevant return code is in the drbd_genlmsghdr. |
| */ |
| GENL_struct(DRBD_NLA_CFG_REPLY, 1, drbd_cfg_reply, |
| /* "arbitrary" size strings, nla_policy.len = 0 */ |
| __str_field(1, GENLA_F_MANDATORY, info_text, 0) |
| ) |
| |
| /* Configuration requests typically need a context to operate on. |
| * Possible keys are device minor (fits in the drbd_genlmsghdr), |
| * the replication link (aka connection) name, |
| * and/or the replication group (aka resource) name, |
| * and the volume id within the resource. */ |
| GENL_struct(DRBD_NLA_CFG_CONTEXT, 2, drbd_cfg_context, |
| __u32_field(1, GENLA_F_MANDATORY, ctx_volume) |
| __str_field(2, GENLA_F_MANDATORY, ctx_conn_name, 128) |
| ) |
| |
| GENL_struct(DRBD_NLA_DISK_CONF, 3, disk_conf, |
| __str_field(1, GENLA_F_REQUIRED | GENLA_F_INVARIANT, backing_dev, 128) |
| __str_field(2, GENLA_F_REQUIRED | GENLA_F_INVARIANT, meta_dev, 128) |
| __u32_field(3, GENLA_F_REQUIRED | GENLA_F_INVARIANT, meta_dev_idx) |
| |
| /* use the resize command to try and change the disk_size */ |
| __u64_field(4, GENLA_F_MANDATORY | GENLA_F_INVARIANT, disk_size) |
| /* we could change the max_bio_bvecs, |
| * but it won't propagate through the stack */ |
| __u32_field(5, GENLA_F_MANDATORY | GENLA_F_INVARIANT, max_bio_bvecs) |
| |
| __u32_field(6, GENLA_F_MANDATORY, on_io_error) |
| __u32_field(7, GENLA_F_MANDATORY, fencing) |
| |
| __u32_field(8, GENLA_F_MANDATORY, resync_rate) |
| __u32_field(9, GENLA_F_MANDATORY, resync_after) |
| __u32_field(10, GENLA_F_MANDATORY, al_extents) |
| __u32_field(11, GENLA_F_MANDATORY, c_plan_ahead) |
| __u32_field(12, GENLA_F_MANDATORY, c_delay_target) |
| __u32_field(13, GENLA_F_MANDATORY, c_fill_target) |
| __u32_field(14, GENLA_F_MANDATORY, c_max_rate) |
| __u32_field(15, GENLA_F_MANDATORY, c_min_rate) |
| |
| __flg_field(16, GENLA_F_MANDATORY, no_disk_barrier) |
| __flg_field(17, GENLA_F_MANDATORY, no_disk_flush) |
| __flg_field(18, GENLA_F_MANDATORY, no_disk_drain) |
| __flg_field(19, GENLA_F_MANDATORY, no_md_flush) |
| |
| ) |
| |
| GENL_struct(DRBD_NLA_RESOURCE_OPTS, 4, res_opts, |
| __str_field(1, GENLA_F_MANDATORY, cpu_mask, 32) |
| __u32_field(2, GENLA_F_MANDATORY, on_no_data) |
| ) |
| |
| GENL_struct(DRBD_NLA_NET_CONF, 5, net_conf, |
| __bin_field(1, GENLA_F_REQUIRED | GENLA_F_INVARIANT, my_addr, 128) |
| __bin_field(2, GENLA_F_REQUIRED | GENLA_F_INVARIANT, peer_addr, 128) |
| __str_field(3, GENLA_F_MANDATORY | GENLA_F_SENSITIVE, |
| shared_secret, SHARED_SECRET_MAX) |
| __str_field(4, GENLA_F_MANDATORY, cram_hmac_alg, SHARED_SECRET_MAX) |
| __str_field(5, GENLA_F_MANDATORY, integrity_alg, SHARED_SECRET_MAX) |
| __str_field(6, GENLA_F_MANDATORY, verify_alg, SHARED_SECRET_MAX) |
| __str_field(7, GENLA_F_MANDATORY, csums_alg, SHARED_SECRET_MAX) |
| __u32_field(8, GENLA_F_MANDATORY, wire_protocol) |
| __u32_field(9, GENLA_F_MANDATORY, try_connect_int) |
| __u32_field(10, GENLA_F_MANDATORY, timeout) |
| __u32_field(11, GENLA_F_MANDATORY, ping_int) |
| __u32_field(12, GENLA_F_MANDATORY, ping_timeo) |
| __u32_field(13, GENLA_F_MANDATORY, sndbuf_size) |
| __u32_field(14, GENLA_F_MANDATORY, rcvbuf_size) |
| __u32_field(15, GENLA_F_MANDATORY, ko_count) |
| __u32_field(16, GENLA_F_MANDATORY, max_buffers) |
| __u32_field(17, GENLA_F_MANDATORY, max_epoch_size) |
| __u32_field(18, GENLA_F_MANDATORY, unplug_watermark) |
| __u32_field(19, GENLA_F_MANDATORY, after_sb_0p) |
| __u32_field(20, GENLA_F_MANDATORY, after_sb_1p) |
| __u32_field(21, GENLA_F_MANDATORY, after_sb_2p) |
| __u32_field(22, GENLA_F_MANDATORY, rr_conflict) |
| __u32_field(23, GENLA_F_MANDATORY, on_congestion) |
| __u32_field(24, GENLA_F_MANDATORY, cong_fill) |
| __u32_field(25, GENLA_F_MANDATORY, cong_extents) |
| __flg_field(26, GENLA_F_MANDATORY, two_primaries) |
| __flg_field(27, GENLA_F_MANDATORY | GENLA_F_INVARIANT, want_lose) |
| __flg_field(28, GENLA_F_MANDATORY, no_cork) |
| __flg_field(29, GENLA_F_MANDATORY, always_asbp) |
| __flg_field(30, GENLA_F_MANDATORY | GENLA_F_INVARIANT, dry_run) |
| __flg_field(31, GENLA_F_MANDATORY, use_rle) |
| ) |
| |
| GENL_struct(DRBD_NLA_SET_ROLE_PARMS, 6, set_role_parms, |
| __flg_field(1, GENLA_F_MANDATORY, assume_uptodate) |
| ) |
| |
| GENL_struct(DRBD_NLA_RESIZE_PARMS, 7, resize_parms, |
| __u64_field(1, GENLA_F_MANDATORY, resize_size) |
| __flg_field(2, GENLA_F_MANDATORY, resize_force) |
| __flg_field(3, GENLA_F_MANDATORY, no_resync) |
| ) |
| |
| GENL_struct(DRBD_NLA_STATE_INFO, 8, state_info, |
| /* the reason of the broadcast, |
| * if this is an event triggered broadcast. */ |
| __u32_field(1, GENLA_F_MANDATORY, sib_reason) |
| __u32_field(2, GENLA_F_REQUIRED, current_state) |
| __u64_field(3, GENLA_F_MANDATORY, capacity) |
| __u64_field(4, GENLA_F_MANDATORY, ed_uuid) |
| |
| /* These are for broadcast from after state change work. |
| * prev_state and new_state are from the moment the state change took |
| * place, new_state is not neccessarily the same as current_state, |
| * there may have been more state changes since. Which will be |
| * broadcasted soon, in their respective after state change work. */ |
| __u32_field(5, GENLA_F_MANDATORY, prev_state) |
| __u32_field(6, GENLA_F_MANDATORY, new_state) |
| |
| /* if we have a local disk: */ |
| __bin_field(7, GENLA_F_MANDATORY, uuids, (UI_SIZE*sizeof(__u64))) |
| __u32_field(8, GENLA_F_MANDATORY, disk_flags) |
| __u64_field(9, GENLA_F_MANDATORY, bits_total) |
| __u64_field(10, GENLA_F_MANDATORY, bits_oos) |
| /* and in case resync or online verify is active */ |
| __u64_field(11, GENLA_F_MANDATORY, bits_rs_total) |
| __u64_field(12, GENLA_F_MANDATORY, bits_rs_failed) |
| |
| /* for pre and post notifications of helper execution */ |
| __str_field(13, GENLA_F_MANDATORY, helper, 32) |
| __u32_field(14, GENLA_F_MANDATORY, helper_exit_code) |
| ) |
| |
| GENL_struct(DRBD_NLA_START_OV_PARMS, 9, start_ov_parms, |
| __u64_field(1, GENLA_F_MANDATORY, ov_start_sector) |
| ) |
| |
| GENL_struct(DRBD_NLA_NEW_C_UUID_PARMS, 10, new_c_uuid_parms, |
| __flg_field(1, GENLA_F_MANDATORY, clear_bm) |
| ) |
| |
| GENL_struct(DRBD_NLA_TIMEOUT_PARMS, 11, timeout_parms, |
| __u32_field(1, GENLA_F_REQUIRED, timeout_type) |
| ) |
| |
| GENL_struct(DRBD_NLA_DISCONNECT_PARMS, 12, disconnect_parms, |
| __flg_field(1, GENLA_F_MANDATORY, force_disconnect) |
| ) |
| |
| /* |
| * Notifications and commands (genlmsghdr->cmd) |
| */ |
| GENL_mc_group(events) |
| |
| /* kernel -> userspace announcement of changes */ |
| GENL_notification( |
| DRBD_EVENT, 1, events, |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED) |
| GENL_tla_expected(DRBD_NLA_STATE_INFO, GENLA_F_REQUIRED) |
| GENL_tla_expected(DRBD_NLA_NET_CONF, GENLA_F_MANDATORY) |
| GENL_tla_expected(DRBD_NLA_DISK_CONF, GENLA_F_MANDATORY) |
| GENL_tla_expected(DRBD_NLA_SYNCER_CONF, GENLA_F_MANDATORY) |
| ) |
| |
| /* query kernel for specific or all info */ |
| GENL_op( |
| DRBD_ADM_GET_STATUS, 2, |
| GENL_op_init( |
| .doit = drbd_adm_get_status, |
| .dumpit = drbd_adm_get_status_all, |
| /* anyone may ask for the status, |
| * it is broadcasted anyways */ |
| ), |
| /* To select the object .doit. |
| * Or a subset of objects in .dumpit. */ |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_MANDATORY) |
| ) |
| |
| #if 0 |
| /* TO BE DONE */ |
| /* create or destroy resources, aka replication groups */ |
| GENL_op(DRBD_ADM_CREATE_RESOURCE, 3, GENL_doit(drbd_adm_create_resource), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| GENL_op(DRBD_ADM_DELETE_RESOURCE, 4, GENL_doit(drbd_adm_delete_resource), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| #endif |
| |
| /* add DRBD minor devices as volumes to resources */ |
| GENL_op(DRBD_ADM_ADD_MINOR, 5, GENL_doit(drbd_adm_add_minor), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| GENL_op(DRBD_ADM_DEL_MINOR, 6, GENL_doit(drbd_adm_delete_minor), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| |
| /* add or delete replication links to resources */ |
| GENL_op(DRBD_ADM_ADD_LINK, 7, GENL_doit(drbd_adm_create_connection), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| GENL_op(DRBD_ADM_DEL_LINK, 8, GENL_doit(drbd_adm_delete_connection), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| |
| GENL_op(DRBD_ADM_RESOURCE_OPTS, 9, |
| GENL_doit(drbd_adm_resource_opts), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED) |
| GENL_tla_expected(DRBD_NLA_RESOURCE_OPTS, GENLA_F_MANDATORY) |
| ) |
| |
| GENL_op( |
| DRBD_ADM_CONNECT, 10, |
| GENL_doit(drbd_adm_connect), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED) |
| GENL_tla_expected(DRBD_NLA_NET_CONF, GENLA_F_REQUIRED) |
| ) |
| |
| GENL_op( |
| DRBD_ADM_CHG_NET_OPTS, 29, |
| GENL_doit(drbd_adm_net_opts), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED) |
| GENL_tla_expected(DRBD_NLA_NET_CONF, GENLA_F_REQUIRED) |
| ) |
| |
| GENL_op(DRBD_ADM_DISCONNECT, 11, GENL_doit(drbd_adm_disconnect), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| |
| GENL_op(DRBD_ADM_ATTACH, 12, |
| GENL_doit(drbd_adm_attach), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED) |
| GENL_tla_expected(DRBD_NLA_DISK_CONF, GENLA_F_REQUIRED) |
| ) |
| |
| GENL_op(DRBD_ADM_CHG_DISK_OPTS, 28, |
| GENL_doit(drbd_adm_disk_opts), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED) |
| GENL_tla_expected(DRBD_NLA_DISK_OPTS, GENLA_F_REQUIRED) |
| ) |
| |
| GENL_op( |
| DRBD_ADM_RESIZE, 13, |
| GENL_doit(drbd_adm_resize), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED) |
| GENL_tla_expected(DRBD_NLA_RESIZE_PARMS, GENLA_F_MANDATORY) |
| ) |
| |
| GENL_op( |
| DRBD_ADM_PRIMARY, 14, |
| GENL_doit(drbd_adm_set_role), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED) |
| GENL_tla_expected(DRBD_NLA_SET_ROLE_PARMS, GENLA_F_REQUIRED) |
| ) |
| |
| GENL_op( |
| DRBD_ADM_SECONDARY, 15, |
| GENL_doit(drbd_adm_set_role), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED) |
| GENL_tla_expected(DRBD_NLA_SET_ROLE_PARMS, GENLA_F_REQUIRED) |
| ) |
| |
| GENL_op( |
| DRBD_ADM_NEW_C_UUID, 16, |
| GENL_doit(drbd_adm_new_c_uuid), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED) |
| GENL_tla_expected(DRBD_NLA_NEW_C_UUID_PARMS, GENLA_F_MANDATORY) |
| ) |
| |
| GENL_op( |
| DRBD_ADM_START_OV, 17, |
| GENL_doit(drbd_adm_start_ov), |
| GENL_tla_expected(DRBD_NLA_START_OV_PARMS, GENLA_F_MANDATORY) |
| ) |
| |
| GENL_op(DRBD_ADM_DETACH, 18, GENL_doit(drbd_adm_detach), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| GENL_op(DRBD_ADM_INVALIDATE, 19, GENL_doit(drbd_adm_invalidate), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| GENL_op(DRBD_ADM_INVAL_PEER, 20, GENL_doit(drbd_adm_invalidate_peer), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| GENL_op(DRBD_ADM_PAUSE_SYNC, 21, GENL_doit(drbd_adm_pause_sync), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| GENL_op(DRBD_ADM_RESUME_SYNC, 22, GENL_doit(drbd_adm_resume_sync), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| GENL_op(DRBD_ADM_SUSPEND_IO, 23, GENL_doit(drbd_adm_suspend_io), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| GENL_op(DRBD_ADM_RESUME_IO, 24, GENL_doit(drbd_adm_resume_io), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| GENL_op(DRBD_ADM_OUTDATE, 25, GENL_doit(drbd_adm_outdate), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| GENL_op(DRBD_ADM_GET_TIMEOUT_TYPE, 26, GENL_doit(drbd_adm_get_timeout_type), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |
| GENL_op(DRBD_ADM_DOWN, 27, GENL_doit(drbd_adm_down), |
| GENL_tla_expected(DRBD_NLA_CFG_CONTEXT, GENLA_F_REQUIRED)) |