@@ -1452,18 +1452,18 @@ include_dir 'conf.d'
1452
1452
mechanism is used.
1453
1453
</para>
1454
1454
<para>
1455
- The command must print the passphrase to the standard output
1456
- and exit with code 0. It can prompt from the terminal if
1457
- <option>--authprompt</option> is used . In the parameter value,
1458
- <literal>%R </literal> represents the file descriptor number opened
1459
- to the terminal that started the server . A file descriptor is only
1460
- available if enabled at server start. If <literal>%R</literal>
1461
- is used and no file descriptor is available, the server will not
1462
- start. Value <literal>%p</literal> is replaced by a pre-defined
1463
- prompt string. (Write <literal>%%</literal> for a literal
1464
- <literal>%</literal>.) Note that the prompt string will probably
1465
- contain whitespace, so be sure to quote its use adequately.
1466
- Newlines are stripped from the end of the output if present .
1455
+ The command must print the passphrase to the standard output and exit
1456
+ with code 0. In the parameter value, <literal>%p</literal> is
1457
+ replaced by a prompt string . (Write <literal>%%</literal> for a
1458
+ literal <literal>%</literal>.) Note that the prompt string will
1459
+ probably contain whitespace, so be sure to quote adequately . A single
1460
+ newline is stripped from the end of the output if present.
1461
+ </para>
1462
+ <para>
1463
+ The command does not actually have to prompt the user for a
1464
+ passphrase. It can read it from a file, obtain it from a keychain
1465
+ facility, or similar. It is up to the user to make sure the chosen
1466
+ mechanism is adequately secure .
1467
1467
</para>
1468
1468
<para>
1469
1469
This parameter can only be set in the <filename>postgresql.conf</filename>
@@ -1486,12 +1486,10 @@ include_dir 'conf.d'
1486
1486
parameter is off (the default), then
1487
1487
<varname>ssl_passphrase_command</varname> will be ignored during a
1488
1488
reload and the SSL configuration will not be reloaded if a passphrase
1489
- is needed. This setting is appropriate for a command that requires a
1490
- terminal for prompting, which will likely not be available when the server is
1491
- running. (<option>--authprompt</option> closes the terminal file
1492
- descriptor soon after server start.) Setting this parameter on
1493
- might be appropriate, for example, if the passphrase is obtained
1494
- from a file.
1489
+ is needed. That setting is appropriate for a command that requires a
1490
+ TTY for prompting, which might not be available when the server is
1491
+ running. Setting this parameter to on might be appropriate if the
1492
+ passphrase is obtained from a file, for example.
1495
1493
</para>
1496
1494
<para>
1497
1495
This parameter can only be set in the <filename>postgresql.conf</filename>
@@ -7818,52 +7816,6 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
7818
7816
</variablelist>
7819
7817
</sect1>
7820
7818
7821
- <sect1 id="runtime-config-encryption">
7822
- <title>Cluster File Encryption</title>
7823
-
7824
- <variablelist>
7825
- <varlistentry id="guc-cluster-key-command" xreflabel="cluster_key_command">
7826
- <term><varname>cluster_key_command</varname> (<type>string</type>)
7827
- <indexterm>
7828
- <primary><varname>cluster_key_command</varname> configuration parameter</primary>
7829
- </indexterm>
7830
- </term>
7831
- <listitem>
7832
- <para>
7833
- This option specifies an external command to obtain the cluster-level
7834
- key for cluster file encryption during server initialization and
7835
- server start.
7836
- </para>
7837
- <para>
7838
- The command must print the cluster key to the standard output as
7839
- 64 hexadecimal characters, and exit with code 0. The command
7840
- can prompt for the passphrase or PIN from the terminal if
7841
- <option>--authprompt</option> is used. In the parameter value,
7842
- <literal>%R</literal> represents the file descriptor number opened
7843
- to the terminal that started the server. A file descriptor is only
7844
- available if enabled at server start. If <literal>%R</literal>
7845
- is used and no file descriptor is available, the server will not
7846
- start. Value <literal>%p</literal> is replaced by a pre-defined
7847
- prompt string. Value <literal>%d</literal> is replaced by the
7848
- directory containing the keys; this is useful if the command
7849
- must create files with the keys, e.g., to store a cluster-level
7850
- key encryped by a key stored in a hardware security module.
7851
- (Write <literal>%%</literal> for a literal <literal>%</literal>.)
7852
- Note that the prompt string will probably contain whitespace,
7853
- so be sure to quote its use adequately. Newlines are stripped
7854
- from the end of the output if present.
7855
- </para>
7856
- <para>
7857
- This parameter can only be set by
7858
- <application>initdb</application>, in the
7859
- <filename>postgresql.conf</filename> file, or on the server
7860
- command line.
7861
- </para>
7862
- </listitem>
7863
- </varlistentry>
7864
- </variablelist>
7865
- </sect1>
7866
-
7867
7819
<sect1 id="runtime-config-client">
7868
7820
<title>Client Connection Defaults</title>
7869
7821
@@ -9685,22 +9637,6 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
9685
9637
</listitem>
9686
9638
</varlistentry>
9687
9639
9688
- <varlistentry id="guc-file-encryption-keylen" xreflabel="file_encryption_keylen">
9689
- <term><varname>file_encryption_keylen</varname> (<type>boolean</type>)
9690
- <indexterm>
9691
- <primary>Cluster file encryption key length</primary>
9692
- </indexterm>
9693
- </term>
9694
- <listitem>
9695
- <para>
9696
- Reports the bit length of the cluster file
9697
- encryption key, or zero if disabled. See <xref
9698
- linkend="app-initdb-cluster-key-command"/> for more
9699
- information.
9700
- </para>
9701
- </listitem>
9702
- </varlistentry>
9703
-
9704
9640
<varlistentry id="guc-data-directory-mode" xreflabel="data_directory_mode">
9705
9641
<term><varname>data_directory_mode</varname> (<type>integer</type>)
9706
9642
<indexterm>
0 commit comments