public inbox for [email protected]  

help / color / mirror / Atom feed

From: =?iso-2022-jp?B?S3Vyb2RhLCBIYXlhdG8vGyRCOXVFRBsoQiAbJEJIOz9NGyhC?= <[email protected]>
To: '[email protected]' <[email protected]>
Subject: [doc] pg_ctl: fix wrong description for -l
Date: Mon, 23 Mar 2026 10:55:03 +0000
Message-ID: <OS9PR01MB1214959BE987B4839E3046050F54BA@OS9PR01MB12149.jpnprd01.prod.outlook.com> (raw)

Hi hackers,

While investigating codes related with the permissions, I found the below
description in the pg_ctl.

```
-l filename
--log=filename
Append the server log output to filename. If the file does not exist, it is created. The umask is set to 077, so access to the log file is disallowed to other users by default.
```

But users who are in the same group can also see the log if group permissions are
enabled on the data directory. It was extended by c37b3d0 but updating the doc seemed
to be missed. Attached patch can fix the issue.

Best regards,
Hayato Kuroda
FUJITSU LIMITED



Attachments:

  [application/octet-stream] 0001-pg_ctl-fix-wrong-description-in-l.patch (1.2K, 2-0001-pg_ctl-fix-wrong-description-in-l.patch)
  download | inline diff:
From 5740b7d100c89f9fb62c78522bd7142a0618c89a Mon Sep 17 00:00:00 2001
From: Hayato Kuroda <[email protected]>
Date: Mon, 23 Mar 2026 19:37:19 +0900
Subject: [PATCH] pg_ctl: fix wrong description in -l

---
 doc/src/sgml/ref/pg_ctl-ref.sgml | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/doc/src/sgml/ref/pg_ctl-ref.sgml b/doc/src/sgml/ref/pg_ctl-ref.sgml
index a0287bb81d6..14ed1e533f3 100644
--- a/doc/src/sgml/ref/pg_ctl-ref.sgml
+++ b/doc/src/sgml/ref/pg_ctl-ref.sgml
@@ -298,9 +298,10 @@ PostgreSQL documentation
       <listitem>
        <para>
         Append the server log output to
-        <replaceable>filename</replaceable>.  If the file does not
-        exist, it is created.  The <systemitem>umask</systemitem> is set to 077,
-        so access to the log file is disallowed to other users by default.
+        <replaceable>filename</replaceable>.  Access to the log file is
+        disallowed to other users by default, but users in the same group as
+        the current user can also read if group permissions are enabled on
+        the specified database directory.
        </para>
       </listitem>
      </varlistentry>
-- 
2.47.3

view thread (9+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: [doc] pg_ctl: fix wrong description for -l
  In-Reply-To: <OS9PR01MB1214959BE987B4839E3046050F54BA@OS9PR01MB12149.jpnprd01.prod.outlook.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox