From: Parav Pandit <parav@nvidia.com>
To: Jakub Kicinski <kuba@kernel.org>, Saeed Mahameed <saeed@kernel.org>
Cc: "David S. Miller" <davem@davemloft.net>,
Jason Gunthorpe <jgg@nvidia.com>,
Leon Romanovsky <leonro@nvidia.com>,
"netdev@vger.kernel.org" <netdev@vger.kernel.org>,
"linux-rdma@vger.kernel.org" <linux-rdma@vger.kernel.org>,
David Ahern <dsahern@kernel.org>,
Jacob Keller <jacob.e.keller@intel.com>,
Sridhar Samudrala <sridhar.samudrala@intel.com>,
"david.m.ertman@intel.com" <david.m.ertman@intel.com>,
"dan.j.williams@intel.com" <dan.j.williams@intel.com>,
"kiran.patil@intel.com" <kiran.patil@intel.com>,
"gregkh@linuxfoundation.org" <gregkh@linuxfoundation.org>,
Jiri Pirko <jiri@nvidia.com>, Vu Pham <vuhuong@nvidia.com>,
Saeed Mahameed <saeedm@nvidia.com>
Subject: RE: [net-next v5 04/15] devlink: Support add and delete devlink port
Date: Wed, 16 Dec 2020 05:06:37 +0000 [thread overview]
Message-ID: <BY5PR12MB4322EDD8E272D34E263CBFA2DCC50@BY5PR12MB4322.namprd12.prod.outlook.com> (raw)
In-Reply-To: <20201215162926.0d7f3683@kicinski-fedora-pc1c0hjn.dhcp.thefacebook.com>
> From: Jakub Kicinski <kuba@kernel.org>
> Sent: Wednesday, December 16, 2020 5:59 AM
>
> > +struct devlink_port_new_attrs {
> > + enum devlink_port_flavour flavour;
> > + unsigned int port_index;
> > + u32 controller;
> > + u32 sfnum;
> > + u16 pfnum;
>
> Oh. So you had the structure which actually gets stored in memory for the
> lifetime of the device in patch 3 mispacked (u32 / u16 / u32 / u8).
> But this one with arguments is packed. Please be consistent.
>
Ok. I will change the packing in patch 3.
> > + u8 port_index_valid:1,
> > + controller_valid:1,
> > + sfnum_valid:1;
> > +};
> > +
> > struct devlink_sb_pool_info {
> > enum devlink_sb_pool_type pool_type;
> > u32 size;
> > @@ -1363,6 +1374,34 @@ struct devlink_ops {
> > int (*port_function_hw_addr_set)(struct devlink *devlink, struct
> devlink_port *port,
> > const u8 *hw_addr, int
> hw_addr_len,
> > struct netlink_ext_ack *extack);
> > + /**
> > + * @port_new: Port add function.
> > + *
> > + * Should be used by device driver to let caller add new port of a
> > + * specified flavour with optional attributes.
>
> Add a new port of a specified flavor with optional attributes.
>
> > + * Driver should return -EOPNOTSUPP if it doesn't support port
> > +addition
>
> s/should/must/
>
Ack.
> > + * of a specified flavour or specified attributes. Driver should set
> > + * extack error message in case of fail to add the port. Devlink
> > +core
>
> s/fail to add the port/failure/
>
Ack.
> > + * does not hold a devlink instance lock when this callback is invoked.
>
> Called without holding the devlink instance lock.
>
Ack.
> > + * Driver must ensures synchronization when adding or deleting a
> port.
>
> s/ensures/ensure/ but really that's pretty obvious from the previous
> sentence.
>
It may be, but this extra clarity helps, so I am going to keep this explicit description.
> > + * Driver must register a port with devlink core.
>
> s/must/is expected to/
>
Ack.
> Please make sure your comments and documentation are proof read by
> someone.
>
Ack.
> > +static int devlink_nl_cmd_port_new_doit(struct sk_buff *skb,
> > + struct genl_info *info)
> > +{
> > + struct netlink_ext_ack *extack = info->extack;
> > + struct devlink_port_new_attrs new_attrs = {};
> > + struct devlink *devlink = info->user_ptr[0];
> > +
> > + if (!info->attrs[DEVLINK_ATTR_PORT_FLAVOUR] ||
> > + !info->attrs[DEVLINK_ATTR_PORT_PCI_PF_NUMBER]) {
> > + NL_SET_ERR_MSG_MOD(extack, "Port flavour or PCI PF are
> not specified");
> > + return -EINVAL;
> > + }
> > + new_attrs.flavour = nla_get_u16(info-
> >attrs[DEVLINK_ATTR_PORT_FLAVOUR]);
> > + new_attrs.pfnum =
> > + nla_get_u16(info-
> >attrs[DEVLINK_ATTR_PORT_PCI_PF_NUMBER]);
> > +
> > + if (info->attrs[DEVLINK_ATTR_PORT_INDEX]) {
> > + new_attrs.port_index =
> > + nla_get_u32(info-
> >attrs[DEVLINK_ATTR_PORT_INDEX]);
> > + new_attrs.port_index_valid = true;
> > + }
>
> This is the desired port index of the new port?
Yes.
> Let's make it abundantly clear since its a pass-thru argument for the driver to
> interpret.
>
Ok. Will add comment here.
> > + if (info->attrs[DEVLINK_ATTR_PORT_CONTROLLER_NUMBER]) {
> > + new_attrs.controller =
> > + nla_get_u16(info-
> >attrs[DEVLINK_ATTR_PORT_CONTROLLER_NUMBER]);
> > + new_attrs.controller_valid = true;
> > + }
> > + if (info->attrs[DEVLINK_ATTR_PORT_PCI_SF_NUMBER]) {
> > + new_attrs.sfnum = nla_get_u32(info-
> >attrs[DEVLINK_ATTR_PORT_PCI_SF_NUMBER]);
> > + new_attrs.sfnum_valid = true;
> > + }
> > +
> > + if (!devlink->ops->port_new)
> > + return -EOPNOTSUPP;
>
> Why is this check not at the beginning of the function?
Will move it up.
> Also should there be an extack on it?
>
Will check, and add if required.
> > + return devlink->ops->port_new(devlink, &new_attrs, extack);
>
> This should return the identifier of the created port back to user space.
Ok. Will add.
next prev parent reply other threads:[~2020-12-16 5:07 UTC|newest]
Thread overview: 46+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-12-15 9:03 [net-next v5 00/15] Add mlx5 subfunction support Saeed Mahameed
2020-12-15 9:03 ` [net-next v5 01/15] net/mlx5: Fix compilation warning for 32-bit platform Saeed Mahameed
2020-12-15 9:03 ` [net-next v5 02/15] devlink: Prepare code to fill multiple port function attributes Saeed Mahameed
2020-12-15 9:03 ` [net-next v5 03/15] devlink: Introduce PCI SF port flavour and port attribute Saeed Mahameed
2020-12-15 23:27 ` Jakub Kicinski
2020-12-16 3:42 ` Parav Pandit
2020-12-16 23:59 ` Jakub Kicinski
2020-12-17 4:44 ` Saeed Mahameed
2020-12-18 19:48 ` Jakub Kicinski
2020-12-19 4:43 ` Parav Pandit
2020-12-15 9:03 ` [net-next v5 04/15] devlink: Support add and delete devlink port Saeed Mahameed
2020-12-16 0:29 ` Jakub Kicinski
2020-12-16 5:06 ` Parav Pandit [this message]
2020-12-15 9:03 ` [net-next v5 05/15] devlink: Support get and set state of port function Saeed Mahameed
2020-12-16 0:37 ` Jakub Kicinski
2020-12-16 5:15 ` Parav Pandit
2020-12-16 16:15 ` David Ahern
2020-12-17 0:08 ` Jakub Kicinski
2020-12-17 5:46 ` Parav Pandit
2020-12-18 19:51 ` Jakub Kicinski
2020-12-19 5:06 ` Parav Pandit
2020-12-15 9:03 ` [net-next v5 06/15] net/mlx5: Introduce vhca state event notifier Saeed Mahameed
2020-12-15 9:03 ` [net-next v5 07/15] net/mlx5: SF, Add auxiliary device support Saeed Mahameed
2020-12-16 0:43 ` Jakub Kicinski
2020-12-16 5:19 ` Parav Pandit
2020-12-17 0:11 ` Jakub Kicinski
2020-12-17 5:23 ` Parav Pandit
2020-12-18 19:58 ` Jakub Kicinski
2020-12-19 4:53 ` Parav Pandit
2020-12-19 17:43 ` Jakub Kicinski
2020-12-15 9:03 ` [net-next v5 08/15] net/mlx5: SF, Add auxiliary device driver Saeed Mahameed
2020-12-15 9:03 ` [net-next v5 09/15] net/mlx5: E-switch, Prepare eswitch to handle SF vport Saeed Mahameed
2020-12-16 0:47 ` Jakub Kicinski
2020-12-16 5:28 ` Parav Pandit
2020-12-15 9:03 ` [net-next v5 10/15] net/mlx5: E-switch, Add eswitch helpers for " Saeed Mahameed
2020-12-15 9:03 ` [net-next v5 11/15] net/mlx5: SF, Add port add delete functionality Saeed Mahameed
2020-12-16 0:51 ` Jakub Kicinski
2020-12-16 5:31 ` Parav Pandit
2020-12-15 9:03 ` [net-next v5 12/15] net/mlx5: SF, Port function state change support Saeed Mahameed
2020-12-15 9:03 ` [net-next v5 13/15] devlink: Add devlink port documentation Saeed Mahameed
2020-12-16 0:57 ` Jakub Kicinski
2020-12-16 5:40 ` Parav Pandit
2020-12-15 9:03 ` [net-next v5 14/15] devlink: Extend devlink port documentation for subfunctions Saeed Mahameed
2020-12-16 1:00 ` Jakub Kicinski
2020-12-16 3:55 ` Parav Pandit
2020-12-15 9:03 ` [net-next v5 15/15] net/mlx5: Add devlink subfunction port documentation Saeed Mahameed
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=BY5PR12MB4322EDD8E272D34E263CBFA2DCC50@BY5PR12MB4322.namprd12.prod.outlook.com \
--to=parav@nvidia.com \
--cc=dan.j.williams@intel.com \
--cc=davem@davemloft.net \
--cc=david.m.ertman@intel.com \
--cc=dsahern@kernel.org \
--cc=gregkh@linuxfoundation.org \
--cc=jacob.e.keller@intel.com \
--cc=jgg@nvidia.com \
--cc=jiri@nvidia.com \
--cc=kiran.patil@intel.com \
--cc=kuba@kernel.org \
--cc=leonro@nvidia.com \
--cc=linux-rdma@vger.kernel.org \
--cc=netdev@vger.kernel.org \
--cc=saeed@kernel.org \
--cc=saeedm@nvidia.com \
--cc=sridhar.samudrala@intel.com \
--cc=vuhuong@nvidia.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).