Linux Manual Pages development
 help / color / mirror / Atom feed
From: Alejandro Colomar <alx@kernel.org>
To: наб <nabijaczleweli@nabijaczleweli.xyz>
Cc: linux-man@vger.kernel.org
Subject: Re: [PATCH] fsync.2: no writability requirements, must operate on directories
Date: Thu, 3 Aug 2023 15:32:52 +0200	[thread overview]
Message-ID: <61f29345-6317-00c7-542e-2b592115ecee@kernel.org> (raw)
In-Reply-To: <4aa54e57-6601-088f-f143-23846af2b783@kernel.org>


[-- Attachment #1.1: Type: text/plain, Size: 1642 bytes --]

On 2023-08-03 15:22, Alejandro Colomar wrote:
> Hi!
> 
> On 2023-08-03 13:52, наб wrote:
>> POSIX has for a long time implied that directories are fsyncable,
>> and since Issue 8 explicitly specifies directory syncing semantics:
>>   https://www.austingroupbugs.net/view.php?id=672
>>
>> Simultaneously, directories being unopenable for writing is a
>> Longest-Standing UNIX Semantic, present in the UNIX Programmer's Manual
>> under directory (V), and has always been enshrined in the standards.
>>
>> Kill the FUD that says that some UNIXes require the fd to be writable:
>> they /must not/ and this confuses users:
>>   https://101010.pl/@eater@cijber.social/110824211348995583
>>
>> Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
>> ---
>>  man2/fsync.2 | 6 ------
>>  1 file changed, 6 deletions(-)
>>
>> diff --git a/man2/fsync.2 b/man2/fsync.2
>> index 1043e6a1b..9ced40b28 100644
>> --- a/man2/fsync.2
>> +++ b/man2/fsync.2
>> @@ -155,12 +155,6 @@ .SH VERSIONS
>>  .\" POSIX.1-2001: It shall be defined to -1 or 0 or 200112L.
>>  .\" -1: unavailable, 0: ask using sysconf().
>>  .\" glibc defines them to 1.
>> -.PP
>> -On some UNIX systems (but not Linux),
>> -.I fd
>> -must be a
>> -.I writable
>> -file descriptor.
> 
> But that's still true.  HP-UX and AIX had that issue.  I'd move
> that paragraph to HISTORY, and say "some old UNIX systems".

s/old/ancient/  :)

> 
> Cheers,
> Alex
> 
>>  .SH STANDARDS
>>  POSIX.1-2008.
>>  .SH HISTORY
> 

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

  reply	other threads:[~2023-08-03 13:37 UTC|newest]

Thread overview: 13+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-08-03 11:52 [PATCH] fsync.2: no writability requirements, must operate on directories наб
2023-08-03 13:22 ` Alejandro Colomar
2023-08-03 13:32   ` Alejandro Colomar [this message]
2023-08-03 14:20   ` наб
2023-08-03 15:18     ` Jakub Wilk
2023-08-03 16:54       ` наб
2023-08-03 18:59         ` G. Branden Robinson
2023-08-04 10:07     ` Guillem Jover
2023-08-04 15:03       ` наб
2023-08-04 15:03         ` [PATCH v3] fsync.2: no writability requirements наб
2023-08-11 23:01           ` Alejandro Colomar
2023-08-03 16:07 ` [PATCH] fsync.2: no writability requirements, must operate on directories Sam James
2023-08-03 16:44   ` наб

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=61f29345-6317-00c7-542e-2b592115ecee@kernel.org \
    --to=alx@kernel.org \
    --cc=linux-man@vger.kernel.org \
    --cc=nabijaczleweli@nabijaczleweli.xyz \
    /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