All of lore.kernel.org
 help / color / mirror / Atom feed
From: Tzung-Bi Shih <tzungbi@kernel.org>
To: Bartosz Golaszewski <brgl@kernel.org>
Cc: Philipp Zabel <p.zabel@pengutronix.de>,
	Jonathan Corbet <corbet@lwn.net>,
	Shuah Khan <skhan@linuxfoundation.org>,
	Randy Dunlap <rdunlap@infradead.org>,
	Linus Walleij <linusw@kernel.org>,
	driver-core@lists.linux.dev, linux-kernel@vger.kernel.org,
	linux-gpio@vger.kernel.org,
	Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
	"Rafael J. Wysocki" <rafael@kernel.org>,
	Danilo Krummrich <dakr@kernel.org>,
	Johan Hovold <johan@kernel.org>
Subject: Re: [PATCH v14 5/5] reset: Leverage revocable for accessing struct reset_controller_dev
Date: Wed, 28 Oct 2026 12:11:18 +0000	[thread overview]
Message-ID: <auHmZhhB9MZj_2ch@google.com> (raw)
In-Reply-To: <CAMRc=MePpaTMC2k8C3B5ue+QtYQQK9vX63n=v18J+fnaX4=0xQ@mail.gmail.com>

On Mon, Oct 19, 2026 at 04:05:21PM +0200, Bartosz Golaszewski wrote:
> On Mon, 19 Oct 2026 14:41:47 +0200, Philipp Zabel <p.zabel@pengutronix.de> said:
> > On Mo, 2026-10-19 at 11:53 +0000, Tzung-Bi Shih wrote:
> >> On Thu, Oct 15, 2026 at 05:49:11AM -0400, Bartosz Golaszewski wrote:
> >> > >  /**
> >> > >   * struct reset_control - a reset control
> >> > > - * @rcdev: a pointer to the reset controller device
> >> > > - *         this reset control belongs to
> >> > > - * @srcu: protects the rcdev pointer from removal during consumer access
> >> > > + * @rev: revocable handle for accessing the reset controller device
> >> >
> >> > Please call it "revocable". The name "rev" does not indicate what it is at all.
> >> > Same elsewhere if you call it the same.
> >>
> >> Ack, I initially used "rev" to keep the lines shorter with the revocable
> >> APIs, but "rev" alone can indeed be confusing.  On the other hand, I feel
> >> "revocable" is a bit verbose and doesn't indicate which target object it
> >> protects.  How about calling it "rcdev_rev"?
> >
> > I strongly associate "rev" with "revision".
> >
> > I'd be fine with "rcdev_revocable" (in struct reset_control and
> > "revocable" in struct reset_controller_device).
> >
> 
> I think "revocable" in both cases is fine. After all: we know what type the
> dereferenced variable is.

Ack, will rename them to `rcdev_revocable` (in `struct reset_control`) and
`revocable` (in `struct reset_controller_dev`).

      reply	other threads:[~2026-10-28 12:11 UTC|newest]

Thread overview: 16+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-10-11 12:12 [PATCH v14 0/5] drivers/base: Introduce revocable Tzung-Bi Shih
2026-10-11 12:12 ` [PATCH v14 1/5] revocable: Revocable resource management Tzung-Bi Shih
2026-10-11 12:12 ` [PATCH v14 2/5] revocable: Add KUnit test cases Tzung-Bi Shih
2026-10-11 12:22   ` sashiko-bot
2026-10-11 12:12 ` [PATCH v14 3/5] gpio: Leverage revocable for accessing struct gpio_chip Tzung-Bi Shih
2026-10-11 12:30   ` sashiko-bot
2026-10-11 12:12 ` [PATCH v14 4/5] reset: Add KUnit test cases Tzung-Bi Shih
2026-10-11 12:25   ` sashiko-bot
2026-10-19 13:32   ` Philipp Zabel
2026-10-28 12:10     ` Tzung-Bi Shih
2026-10-11 12:12 ` [PATCH v14 5/5] reset: Leverage revocable for accessing struct reset_controller_dev Tzung-Bi Shih
2026-10-15  9:49   ` Bartosz Golaszewski
2026-10-19 11:53     ` Tzung-Bi Shih
2026-10-19 12:41       ` Philipp Zabel
2026-10-19 14:05         ` Bartosz Golaszewski
2026-10-28 12:11           ` Tzung-Bi Shih [this message]

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=auHmZhhB9MZj_2ch@google.com \
    --to=tzungbi@kernel.org \
    --cc=brgl@kernel.org \
    --cc=corbet@lwn.net \
    --cc=dakr@kernel.org \
    --cc=driver-core@lists.linux.dev \
    --cc=gregkh@linuxfoundation.org \
    --cc=johan@kernel.org \
    --cc=linusw@kernel.org \
    --cc=linux-gpio@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=p.zabel@pengutronix.de \
    --cc=rafael@kernel.org \
    --cc=rdunlap@infradead.org \
    --cc=skhan@linuxfoundation.org \
    /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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.