git.postgresql.org Git - postgresql.git/commitdiff

git projects / postgresql.git / commitdiff

doc: explain how the home directory is found on Unix-like syst.

Fri, 1 Nov 2024 17:32:21 +0000 (13:32 -0400)

committer Bruce Momjian <bruce@momjian.us>

Fri, 1 Nov 2024 17:32:21 +0000 (13:32 -0400)

Done for libpq, postgres-fdw, and psql.

Reported-by: marc@msys.ch
Discussion: https://postgr.es/m/CAKFQuwZ-T-zsVM7gApS9-XU9vGxC7Oa-UyRQPVcJFagNU=AjOw@mail.gmail.com

Backpatch-through: master

doc/src/sgml/libpq.sgml patch | blob | blame | history

doc/src/sgml/postgres-fdw.sgml patch | blob | blame | history

doc/src/sgml/ref/psql-ref.sgml patch | blob | blame | history

diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml

index afc9346757a7241db84b294a576994b32ea56633..bfefb1289e8a777753808034a3391599db665dfc 100644 (file)

--- a/doc/src/sgml/libpq.sgml

+++ b/doc/src/sgml/libpq.sgml

@@ -9256,7 +9256,9 @@ myEventProc(PGEventId evtId, void *evtInfo, void *passThrough)

The file <filename>.pgpass</filename> in a user's home directory can

contain passwords to

be used if the connection requires a password (and no password has been

- specified otherwise). On Microsoft Windows the file is named

+ specified otherwise). On Unix systems, the directory can be specified by

+ the <envar>HOME</envar> environment variable, or if undefined, the home

+ directory of the effective user. On Microsoft Windows the file is named

<filename>%APPDATA%\postgresql\pgpass.conf</filename> (where

<filename>%APPDATA%</filename> refers to the Application Data subdirectory in

the user's profile).

diff --git a/doc/src/sgml/postgres-fdw.sgml b/doc/src/sgml/postgres-fdw.sgml

index 627bb5ab5ccd1ad096edfb417cf9f308801a739d..188e8f0b4d0e862edb0d218b8e341a90db98da88 100644 (file)

--- a/doc/src/sgml/postgres-fdw.sgml

+++ b/doc/src/sgml/postgres-fdw.sgml

@@ -194,7 +194,9 @@ OPTIONS (ADD password_required 'false');

user can potentially use any client certificates,

<filename>.pgpass</filename>,

<filename>.pg_service.conf</filename> etc. in the unix home directory of the

- system user the postgres server runs as. They can also use any trust

+ system user the postgres server runs as. (For details on how home

+ directories are found, see <xref linkend="libpq-pgpass"/>.) They can

+ also use any trust

relationship granted by authentication modes like <literal>peer</literal>

or <literal>ident</literal> authentication.

</para>

diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml

index b825ca96a2373154221923f6b68f9c62a0918df1..e42073ed7483aa32b23acf420a86d12cead86538 100644 (file)

--- a/doc/src/sgml/ref/psql-ref.sgml

+++ b/doc/src/sgml/ref/psql-ref.sgml

@@ -1048,7 +1048,8 @@ INSERT INTO tbls1 VALUES (1,ドル 2ドル) \parse stmt1

<para>

Changes the current working directory to

<replaceable>directory</replaceable>. Without argument, changes

- to the current user's home directory.

+ to the current user's home directory. For details on how home

+ directories are found, see <xref linkend="libpq-pgpass"/>.

</para>

<tip>

This is the main PostgreSQL git repository.

RSS Atom