database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-07-21 16:02:15 +03:00
Code Activity

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

Browse Source 
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
This commit is contained in:
Bruce Momjian
2024-11-01 13:32:21 -04:00
parent 1eb5564230
commit 94a8c19eed
3 changed files with 8 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
doc/src/sgml/libpq.sgml
View File

@ -9256,7 +9256,9 @@ myEventProc(PGEventId evtId, void *evtInfo, void *passThrough)
The file <filename>.pgpass</filename> in a user's home directory can The file <filename>.pgpass</filename> in a user's home directory can
contain passwords to contain passwords to
be used if the connection requires a password (and no password has been 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%\postgresql\pgpass.conf</filename> (where
<filename>%APPDATA%</filename> refers to the Application Data subdirectory in <filename>%APPDATA%</filename> refers to the Application Data subdirectory in
the user's profile). the user's profile).

4
doc/src/sgml/postgres-fdw.sgml
View File

@ -194,7 +194,9 @@ OPTIONS (ADD password_required 'false');
user can potentially use any client certificates, user can potentially use any client certificates,
<filename>.pgpass</filename>, <filename>.pgpass</filename>,
<filename>.pg_service.conf</filename> etc. in the unix home directory of the <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> relationship granted by authentication modes like <literal>peer</literal>
or <literal>ident</literal> authentication. or <literal>ident</literal> authentication.
</para> </para>

3
doc/src/sgml/ref/psql-ref.sgml
View File

@ -1048,7 +1048,8 @@ INSERT INTO tbls1 VALUES ($1, $2) \parse stmt1
<para> <para>
Changes the current working directory to Changes the current working directory to
<replaceable>directory</replaceable>. Without argument, changes <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> </para>
<tip> <tip>