From: Guenter Roeck <linux@roeck-us.net>
To: Rasmus Villemoes <linux@rasmusvillemoes.dk>,
"linux-watchdog@vger.kernel.org" <linux-watchdog@vger.kernel.org>
Subject: Re: watchdog ioctl inconsistencies
Date: Mon, 26 Aug 2019 17:19:05 -0700 [thread overview]
Message-ID: <d9e38bb0-59a0-8659-ac44-e58d0ff25940@roeck-us.net> (raw)
In-Reply-To: <2d39e6c4-c9ef-4dce-4cce-14b77f331f81@rasmusvillemoes.dk>
On 8/26/19 5:54 AM, Rasmus Villemoes wrote:
> Hi,
>
> uapi/linux/watchdog.h has these
>
> #define WDIOC_SETOPTIONS _IOR(WATCHDOG_IOCTL_BASE, 4, int)
>
> This is a write from userspace perspective, so should have been _IOW.
>
> #define WDIOC_KEEPALIVE _IOR(WATCHDOG_IOCTL_BASE, 5, int)
>
> This one doesn't actually take an argument, so should just have been an
> _IO - or if anything, an _IOW. One could be misled to think that if the
> int argument has 'V' somewhere (perhaps first or last byte, depending on
> endianness) that would count as a magic close.
>
> #define WDIOC_SETTIMEOUT _IOWR(WATCHDOG_IOCTL_BASE, 6, int)
> #define WDIOC_SETPRETIMEOUT _IOWR(WATCHDOG_IOCTL_BASE, 8, int)
>
> The SETTIMEOUT handling does fall through to the GETTIMEOUT case, so
> that one is indeed a "write this, but tell me what value actually took
> effect". The SETPRETIMEOUT case ends with a break, so that one is really
> _IOW.
>
> There's not much to do about these, I think, but perhaps one could add a
> comment to the uapi header containing the magic explains-all phrase
> "historical reasons".
>
Those ioctls were imported into git when the git repository was created.
I don't think it is worth bothering about it now. I also don't think it
would add much if any value to add "historic reason" comments.
Guenter
prev parent reply other threads:[~2019-08-27 0:19 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-08-26 12:54 watchdog ioctl inconsistencies Rasmus Villemoes
2019-08-27 0:19 ` Guenter Roeck [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=d9e38bb0-59a0-8659-ac44-e58d0ff25940@roeck-us.net \
--to=linux@roeck-us.net \
--cc=linux-watchdog@vger.kernel.org \
--cc=linux@rasmusvillemoes.dk \
/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).