LU-12410 lnet: Convert lnetctl peer add and del

[fs/lustre-release.git] / lnet / utils / lnetconfig / liblnetconfig.h

diff --git a/lnet/utils/lnetconfig/liblnetconfig.h b/lnet/utils/lnetconfig/liblnetconfig.h
index 5c5fb6a..163a146 100644 (file)
--- a/lnet/utils/lnetconfig/liblnetconfig.h
+++ b/lnet/utils/lnetconfig/liblnetconfig.h
@@ -54,6 +54,12 @@ enum lnetctl_cmd {
        LNETCTL_LAST_CMD
 };
 
+/*
+ * Max number of nids we'll configure for a single peer via a single DLC
+ * operation
+ */
+#define LNET_MAX_NIDS_PER_PEER 128
+
 struct lnet_dlc_network_descr {
        struct list_head network_on_rule;
        __u32 nw_id;
@@ -532,6 +538,30 @@ int lustre_lnet_config_peer_nid(char *pnid, char **nid, int num_nids,
                                struct cYAML **err_rc);
 
 /*
+ * lustre_lnet_config_peer_nidlist
+ *  Add a peer NID to a peer with primary NID pnid. If a pnid is not provided
+ *  then the first NID in the NID list becomes the primary NID for a newly
+ *  created peer.
+ *  Otherwise, if the provided primary NID is unique, then a new peer is
+ *  created with this primary NID, and the NIDs in the NID list are added as
+ *  secondary NIDs to this new peer.
+ *  If any of the NIDs in the NID list are not unique then the operation
+ *  fails. Some peer NIDs might have already been added. It's the responsibility
+ *  of the caller of this API to remove the added NIDs if so desired.
+ *
+ *     pnid - The desired primary NID of a new peer, or the primary NID of
+ *            an existing peer.
+ *     lnet_nidlist - List of LNet NIDs to add to the peer
+ *     num_nids - The number of LNet NIDs in the lnet_nidlist array
+ *     mr - Specifies whether this peer is MR capable.
+ *     seq_no - sequence number of the command
+ *     err_rc - YAML structure of the resultant return code
+ */
+int lustre_lnet_config_peer_nidlist(char *pnid, lnet_nid_t *lnet_nidlist,
+                                   int num_nids, bool mr, int seq_no,
+                                   struct cYAML **err_rc);
+
+/*
  * lustre_lnet_del_peer_nid
  *  Delete the nids given in the nid list from the peer with primary NID
  *  pnid. If pnid is NULL or it doesn't identify a peer the operation
@@ -549,6 +579,22 @@ int lustre_lnet_del_peer_nid(char *pnid, char **nid, int num_nids,
                             bool ip2nets, int seq_no, struct cYAML **err_rc);
 
 /*
+ * lustre_lnet_del_peer_nidlist
+ *  Delete the NIDs given in the NID list from the peer with the primary NID
+ *  pnid. If pnid is NULL, or it doesn't identify a peer, the operation fails,
+ *  and no change happens to the system.
+ *  The operation is aborted on the first NID that fails to be deleted.
+ *
+ *     pnid - The primary NID of the peer to be modified
+ *     lnet_nidlist - The list of LNet NIDs to delete from the peer
+ *     num_nids - the number of nids in the lnet_nidlist array
+ *     seq_no - sequence number of the command
+ *     err_rc - YAML structure of the resultant return code
+ */
+int lustre_lnet_del_peer_nidlist(char *pnid, lnet_nid_t *lnet_nidlist,
+                                int num_nids, int seq_no,
+                                struct cYAML **err_rc);
+/*
  * lustre_lnet_show_peer
  *   Show the peer identified by nid, knid. If knid is NULL all
  *   peers in the system are shown.