* Dr. David Alan Gilbert (linux@xxxxxxxxxxx) wrote:
> * Arnaud POULIQUEN (arnaud.pouliquen@xxxxxxxxxxx) wrote:
> > Hello,
> >
> > On 4/20/25 22:41, linux@xxxxxxxxxxx wrote:
> > > From: "Dr. David Alan Gilbert" <linux@xxxxxxxxxxx>
> > >
> > > rpmsg_send_offchannel() and rpmsg_trysend_offchannel() have been
> > > unused since they were added in 2011's
> > > commit bcabbccabffe ("rpmsg: add virtio-based remote processor messaging
> > > bus")
> > >
> > > Remove them and associated docs.
> > >
> > > I suspect this means the trysend_offchannel and send_offchannel
> > > member function pointers and the virtio implementation of them can be
> > > removed as well, but haven't yet gone that far.
> >
> > It seems to me that this API is not safe as it allows an endpoint to usurp the
> > identity of another one thanks to the source address.
> >
> > So, +1 to remove it.
> >
> > That said, to complete the remove it would be nice to also remove associated ops
> > declared in rpmsg_endpoint_ops and implemented in virtio_rpmsg_bus.c.
>
> OK, yes I was thinking that but wasn't sure - I'll cut some follow up patches
Sent, see v2 series starting with message 20250424142746.79062-1-linux@xxxxxxxxxxx.
Thanks!
Dave
> Dave
>
> > Regards,
> > Arnaud
> >
> >
> > >
> > > Signed-off-by: Dr. David Alan Gilbert <linux@xxxxxxxxxxx>
> > > ---
> > > Documentation/staging/rpmsg.rst | 46 ------------------------
> > > drivers/rpmsg/rpmsg_core.c | 63 ---------------------------------
> > > include/linux/rpmsg.h | 22 ------------
> > > 3 files changed, 131 deletions(-)
> > >
> > > diff --git a/Documentation/staging/rpmsg.rst b/Documentation/staging/rpmsg.rst
> > > index 3713adaa1608..40282cca86ca 100644
> > > --- a/Documentation/staging/rpmsg.rst
> > > +++ b/Documentation/staging/rpmsg.rst
> > > @@ -110,31 +110,6 @@ or a timeout of 15 seconds elapses. When the latter happens,
> > > The function can only be called from a process context (for now).
> > > Returns 0 on success and an appropriate error value on failure.
> > >
> > > -::
> > > -
> > > - int rpmsg_send_offchannel(struct rpmsg_endpoint *ept, u32 src, u32 dst,
> > > - void *data, int len);
> > > -
> > > -
> > > -sends a message across to the remote processor, using the src and dst
> > > -addresses provided by the user.
> > > -
> > > -The caller should specify the endpoint, the data it wants to send,
> > > -its length (in bytes), and explicit source and destination addresses.
> > > -The message will then be sent to the remote processor to which the
> > > -endpoint's channel belongs, but the endpoint's src and channel dst
> > > -addresses will be ignored (and the user-provided addresses will
> > > -be used instead).
> > > -
> > > -In case there are no TX buffers available, the function will block until
> > > -one becomes available (i.e. until the remote processor consumes
> > > -a tx buffer and puts it back on virtio's used descriptor ring),
> > > -or a timeout of 15 seconds elapses. When the latter happens,
> > > --ERESTARTSYS is returned.
> > > -
> > > -The function can only be called from a process context (for now).
> > > -Returns 0 on success and an appropriate error value on failure.
> > > -
> > > ::
> > >
> > > int rpmsg_trysend(struct rpmsg_endpoint *ept, void *data, int len);
> > > @@ -173,27 +148,6 @@ return -ENOMEM without waiting until one becomes available.
> > > The function can only be called from a process context (for now).
> > > Returns 0 on success and an appropriate error value on failure.
> > >
> > > -::
> > > -
> > > - int rpmsg_trysend_offchannel(struct rpmsg_endpoint *ept, u32 src, u32 dst,
> > > - void *data, int len);
> > > -
> > > -
> > > -sends a message across to the remote processor, using source and
> > > -destination addresses provided by the user.
> > > -
> > > -The user should specify the channel, the data it wants to send,
> > > -its length (in bytes), and explicit source and destination addresses.
> > > -The message will then be sent to the remote processor to which the
> > > -channel belongs, but the channel's src and dst addresses will be
> > > -ignored (and the user-provided addresses will be used instead).
> > > -
> > > -In case there are no TX buffers available, the function will immediately
> > > -return -ENOMEM without waiting until one becomes available.
> > > -
> > > -The function can only be called from a process context (for now).
> > > -Returns 0 on success and an appropriate error value on failure.
> > > -
> > > ::
> > >
> > > struct rpmsg_endpoint *rpmsg_create_ept(struct rpmsg_device *rpdev,
> > > diff --git a/drivers/rpmsg/rpmsg_core.c b/drivers/rpmsg/rpmsg_core.c
> > > index 207b64c0a2fe..6ee36adcbdba 100644
> > > --- a/drivers/rpmsg/rpmsg_core.c
> > > +++ b/drivers/rpmsg/rpmsg_core.c
> > > @@ -193,38 +193,6 @@ int rpmsg_sendto(struct rpmsg_endpoint *ept, void *data, int len, u32 dst)
> > > }
> > > EXPORT_SYMBOL(rpmsg_sendto);
> > >
> > > -/**
> > > - * rpmsg_send_offchannel() - send a message using explicit src/dst addresses
> > > - * @ept: the rpmsg endpoint
> > > - * @src: source address
> > > - * @dst: destination address
> > > - * @data: payload of message
> > > - * @len: length of payload
> > > - *
> > > - * This function sends @data of length @len to the remote @dst address,
> > > - * and uses @src as the source address.
> > > - * The message will be sent to the remote processor which the @ept
> > > - * endpoint belongs to.
> > > - * In case there are no TX buffers available, the function will block until
> > > - * one becomes available, or a timeout of 15 seconds elapses. When the latter
> > > - * happens, -ERESTARTSYS is returned.
> > > - *
> > > - * Can only be called from process context (for now).
> > > - *
> > > - * Return: 0 on success and an appropriate error value on failure.
> > > - */
> > > -int rpmsg_send_offchannel(struct rpmsg_endpoint *ept, u32 src, u32 dst,
> > > - void *data, int len)
> > > -{
> > > - if (WARN_ON(!ept))
> > > - return -EINVAL;
> > > - if (!ept->ops->send_offchannel)
> > > - return -ENXIO;
> > > -
> > > - return ept->ops->send_offchannel(ept, src, dst, data, len);
> > > -}
> > > -EXPORT_SYMBOL(rpmsg_send_offchannel);
> > > -
> > > /**
> > > * rpmsg_trysend() - send a message across to the remote processor
> > > * @ept: the rpmsg endpoint
> > > @@ -301,37 +269,6 @@ __poll_t rpmsg_poll(struct rpmsg_endpoint *ept, struct file *filp,
> > > }
> > > EXPORT_SYMBOL(rpmsg_poll);
> > >
> > > -/**
> > > - * rpmsg_trysend_offchannel() - send a message using explicit src/dst addresses
> > > - * @ept: the rpmsg endpoint
> > > - * @src: source address
> > > - * @dst: destination address
> > > - * @data: payload of message
> > > - * @len: length of payload
> > > - *
> > > - * This function sends @data of length @len to the remote @dst address,
> > > - * and uses @src as the source address.
> > > - * The message will be sent to the remote processor which the @ept
> > > - * endpoint belongs to.
> > > - * In case there are no TX buffers available, the function will immediately
> > > - * return -ENOMEM without waiting until one becomes available.
> > > - *
> > > - * Can only be called from process context (for now).
> > > - *
> > > - * Return: 0 on success and an appropriate error value on failure.
> > > - */
> > > -int rpmsg_trysend_offchannel(struct rpmsg_endpoint *ept, u32 src, u32 dst,
> > > - void *data, int len)
> > > -{
> > > - if (WARN_ON(!ept))
> > > - return -EINVAL;
> > > - if (!ept->ops->trysend_offchannel)
> > > - return -ENXIO;
> > > -
> > > - return ept->ops->trysend_offchannel(ept, src, dst, data, len);
> > > -}
> > > -EXPORT_SYMBOL(rpmsg_trysend_offchannel);
> > > -
> > > /**
> > > * rpmsg_set_flow_control() - request remote to pause/resume transmission
> > > * @ept: the rpmsg endpoint
> > > diff --git a/include/linux/rpmsg.h b/include/linux/rpmsg.h
> > > index 90d8e4475f80..fb7ab9165645 100644
> > > --- a/include/linux/rpmsg.h
> > > +++ b/include/linux/rpmsg.h
> > > @@ -184,13 +184,9 @@ struct rpmsg_endpoint *rpmsg_create_ept(struct rpmsg_device *,
> > >
> > > int rpmsg_send(struct rpmsg_endpoint *ept, void *data, int len);
> > > int rpmsg_sendto(struct rpmsg_endpoint *ept, void *data, int len, u32 dst);
> > > -int rpmsg_send_offchannel(struct rpmsg_endpoint *ept, u32 src, u32 dst,
> > > - void *data, int len);
> > >
> > > int rpmsg_trysend(struct rpmsg_endpoint *ept, void *data, int len);
> > > int rpmsg_trysendto(struct rpmsg_endpoint *ept, void *data, int len, u32 dst);
> > > -int rpmsg_trysend_offchannel(struct rpmsg_endpoint *ept, u32 src, u32 dst,
> > > - void *data, int len);
> > >
> > > __poll_t rpmsg_poll(struct rpmsg_endpoint *ept, struct file *filp,
> > > poll_table *wait);
> > > @@ -271,15 +267,6 @@ static inline int rpmsg_sendto(struct rpmsg_endpoint *ept, void *data, int len,
> > >
> > > }
> > >
> > > -static inline int rpmsg_send_offchannel(struct rpmsg_endpoint *ept, u32 src,
> > > - u32 dst, void *data, int len)
> > > -{
> > > - /* This shouldn't be possible */
> > > - WARN_ON(1);
> > > -
> > > - return -ENXIO;
> > > -}
> > > -
> > > static inline int rpmsg_trysend(struct rpmsg_endpoint *ept, void *data, int len)
> > > {
> > > /* This shouldn't be possible */
> > > @@ -297,15 +284,6 @@ static inline int rpmsg_trysendto(struct rpmsg_endpoint *ept, void *data,
> > > return -ENXIO;
> > > }
> > >
> > > -static inline int rpmsg_trysend_offchannel(struct rpmsg_endpoint *ept, u32 src,
> > > - u32 dst, void *data, int len)
> > > -{
> > > - /* This shouldn't be possible */
> > > - WARN_ON(1);
> > > -
> > > - return -ENXIO;
> > > -}
> > > -
> > > static inline __poll_t rpmsg_poll(struct rpmsg_endpoint *ept,
> > > struct file *filp, poll_table *wait)
> > > {
> --
> -----Open up your eyes, open up your mind, open up your code -------
> / Dr. David Alan Gilbert | Running GNU/Linux | Happy \
> \ dave @ treblig.org | | In Hex /
> \ _________________________|_____ http://www.treblig.org |_______/
>
--
-----Open up your eyes, open up your mind, open up your code -------
/ Dr. David Alan Gilbert | Running GNU/Linux | Happy \
\ dave @ treblig.org | | In Hex /
\ _________________________|_____ http://www.treblig.org |_______/
